i18n 国际化 Key 生成器

把界面文案批量生成规范的翻译 key:中文按拼音、英文按单词,可选命名风格和命名空间,自动去重并保留 {name} 这类插值;也可以直接粘贴 React、Vue、HTML 或 JavaScript 代码,提取其中硬编码的中文,替换成 t('key') 并生成语言包。

key 对照表(可以直接修改 key)

翻译 key 怎么命名

  • 按页面或模块分组:用命名空间区分,如 login.submit_button、order.status_paid,同一个词在不同页面可能需要不同的译法(“关闭”可以是 close 也可以是 off),分组后可以分别翻译。
  • 描述含义而不是照抄文字:key 写成 error.network_timeout 比 wang_luo_chao_shi_qing_zhong_shi 更好维护。本工具生成的 key 是起点,建议在对照表中把重要的 key 改成有意义的英文。
  • 插值不要拼接:“共 {count} 条”应该作为一条完整文案翻译,而不是拆成“共”和“条”拼接,因为不同语言的语序不同。
  • 复数和性别:英文需要区分单复数,i18next 用 key_one、key_other,vue-i18n 用 | 分隔;中文虽然不需要,但生成语言包时要为其他语言留出位置。
  • 提取后要人工检查:自动提取会跳过注释,但可能包含日志、接口返回值比对等不需要翻译的字符串,替换前请逐条确认。

文本的拼音可以用拼音转换工具查看,变量命名风格转换可以用命名格式转换工具。

i18n 国际化 Key 生成器常见问题

i18n 国际化 Key 生成器怎么使用?

在“从文案生成”中每行输入一条文案,或切换到“从代码中提取”粘贴 React、Vue、HTML、JavaScript 代码;设置命名空间、命名风格、中文转换方式和 key 的最大词数,右侧切换 JSON、嵌套 JSON、YAML、properties 语言包或替换后的代码,在对照表中可以直接修改 key。

i18n 的 key 应该怎么命名?

按页面或模块分组,用英文描述文案的用途,例如 login.submit_button。

怎么批量提取代码里的中文?

切换到“从代码中提取”,粘贴组件代码,工具会找出文字和字符串中的中文并替换成 t('key')。

相同的文案会生成两个 key 吗?

不会,相同的文案共用一个 key;不同文案生成了相同的 key 时会自动加数字后缀。

插值变量怎么处理?

{name}、{{count}} 这类插值会保留在文案中,生成 key 时会忽略它们。

i18n 国际化 Key 生成器的结果应怎样理解?

中文 key 由拼音生成,可读性有限,重要的 key 建议手动改成英文;代码提取基于文本匹配,会跳过注释,但可能包含日志等不需要翻译的字符串,替换前请检查。

输入内容会保存或发给外部服务吗?

文案和代码只在浏览器本地处理,不会上传。

没有结果或操作失败时先检查什么?

提取结果中混入了不该翻译的字符串时,在对照表中记下后从替换后的代码里恢复;Vue 单文件组件中 script 部分的字符串需要配合 useI18n 的 t 函数使用。

相关工具

键盘事件 keyCode 查询 · JSON 格式化校验 · Base64 编码解码 · URL 编码解码 · 全部开发工具