You need to enable JavaScript to run this app. 使用i18-next的Web应用如何自动检测未完成本地化的字符串?
优惠活动
大模型
产品
解决方案
定价
更多

使用i18-next的Web应用如何自动检测未完成本地化的字符串?

i18n硬编码字符串规避&自动检测方案

1 开发阶段前置拦截(从源头避免漏写)

  • 接入ESLint校验规则:使用eslint-plugin-i18next插件,开启核心规则i18next/no-literal-string,该规则会自动识别JSX/TSX内的展示类文本、组件props传入的字符串,未包裹在t()函数内的内容会直接抛出错误。可通过规则配置过滤例外场景:比如纯数字、特殊符号、日志打印字符串、className/id/data-*等非展示属性的取值,避免误报。将该规则等级设为error后,本地开发、代码提交、CI流水线阶段只要命中规则就会阻断流程,从开发环节拦截问题。
  • TypeScript类型约束:如果项目用TS,可以将i18n资源文件的类型导出,把所有接收文案参数的组件props类型定义为keyof typeof I18nResourceType,从类型层面限制只能传入合法的i18n key,根本无法传入硬编码字符串。

2 全量静态自动检测(无需人工排查)

  • 自定义AST扫描脚本:使用@babel/parser等AST解析工具遍历项目内所有.js/.jsx/.ts/.tsx源码文件,转换为抽象语法树后匹配两类节点:① 非空白、非纯数字/符号的JSX文本节点;② 展示类props(比如title/placeholder/content等)的字符串值。只要两类节点的父节点不是t()函数的调用参数,就标记为漏处理的硬编码字符串,自动导出检测报告,全量扫描一次耗时最多几秒,适合定期排查历史遗留问题。
  • 构建阶段嵌入检测逻辑:给Vite/Webpack写自定义插件,在构建生产包的流程中自动跑上述AST扫描逻辑,只要检测到未处理的硬编码字符串就直接终止构建,确保上线的代码不存在漏做国际化的内容。

3 运行时兜底&二次校验

  • 封装t()函数增加校验逻辑:在原有i18n t函数外层包一层自定义逻辑,开发环境下如果传入的key不存在于当前语言的资源文件中,直接弹窗抛出明确错误;生产环境下如果命中缺失的key,自动上报埋点,同时兜底展示预设的默认文案,避免出现线上显示异常。
  • E2E测试附加校验:在端到端测试用例执行过程中,增加全局逻辑提取当前页面所有可见DOM的文本内容,和i18n资源文件的所有value做匹配,如果出现不在资源池内的可见文本,直接记录测试失败,在功能测试的同时完成国际化覆盖度校验。

4 流程辅助减少遗漏

  • 需求评审阶段就同步梳理本次迭代需要新增的i18n key,提前安排翻译,避免开发阶段因为等不到翻译内容图方便写硬编码。
  • 代码评审环节将ESLint的i18n校验结果作为必查项,双重保障没有遗漏。

内容的提问来源于stack exchange,提问作者Hari Krishnan

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.18 13:36:04