Angular 9升级后i18n翻译缺失求助：ID格式不匹配

你遇到的问题核心是Angular 9对i18n的trans-unit ID生成机制做了重大变更——默认采用了新的数字哈希ID，而你项目里的旧翻译文件还在使用Angular 9之前的字符串哈希ID，两者不匹配就导致了翻译找不到的错误。下面给你两种可行的解决方案：

方案一：启用Legacy ID格式（继续使用旧ID规则） #

如果你想保留现有的messages.xlf文件格式，不需要重新生成ID，可以通过配置让Angular 9及后续版本兼容旧格式：

1. 修改angular.json配置
   找到你项目对应的architect -> build -> options节点，添加i18n配置项：

   "options": {
     // 其他现有配置
     "i18n": {
       "format": "xlf",
       "useLegacyIdFormat": true
     }
   }
   

   同时，如果你需要重新提取翻译文本，也要在architect -> extract-i18n -> options里加上同样的配置，或者直接在命令行使用参数：

   ng extract-i18n --use-legacy-id-format
   

2. 验证配置生效
   重新构建项目，Angular就会按照旧规则识别你的trans-unit ID，不会再抛出缺失错误。

方案二：迁移到新ID格式（推荐长期方案） #

如果打算适配Angular的新规范，可以把现有翻译文件迁移到新ID格式：

1. 重新提取基准messages.xlf
   先运行提取命令生成带新数字ID的基准文件：

   ng extract-i18n
   

   这个新文件里的trans-unit ID就是Angular 9默认的数字哈希格式。

2. 迁移旧翻译内容
   因为新旧文件的<source>文本是一致的（比如都是"Dashboard"），你可以：

   • 手动把旧文件里的<target>内容复制到新文件对应的<source>条目下；
   • 用自动化工具（比如xliffmerge）来批量映射，它能根据source文本自动合并新旧翻译内容，减少手动工作量。

3. 替换项目中的翻译文件
   把迁移好的新messages.xlf文件替换掉旧文件，后续构建和提取都使用新格式即可。

额外注意事项 #

• 如果你使用了第三方i18n管理工具，要确保工具支持Angular的legacy ID格式或者新ID格式；
• 如果你之前给trans-unit设置了自定义ID（而非自动生成的哈希），这类ID不受格式变更影响，可以正常使用。

内容的提问来源于stack exchange，提问作者Glenn Utter