技能介绍

要解决的国际化痛点

Angular 7 项目的国际化落地常卡在几个环节：版本兼容性要求严格（比如 Node.js 必须固定到 10.16.2，否则依赖安装容易出错）；NG-ZORRO 7.x 组件的国际化适配需要修改共享模块配置，手动调整容易遗漏；硬编码中文分散在 .ts 和 .html 文件里，手动整理翻译文件耗时且易出现 zh.json 与 en.json key 不匹配的问题；老项目改造时，替换旧的 isop-design 依赖、调整语言服务配置的步骤繁琐，容易踩坑。

技能的核心能力与实现逻辑

这套技能将国际化拆分为四个子模块，覆盖从新项目初始化到老项目改造的全流程：

i18n-core：负责核心配置，包括安装 @ngx-translate/core@11.0.1 和 @ngx-translate/http-loader@4.0.0，创建 language.service.ts 语言管理服务，配置 app.module.ts 中的 APP_INITIALIZER，同时处理旧依赖的卸载与替换（如移除 isop-design，安装 isop-design-i18n）。
i18n-translate：通过 Python 脚本自动扫描硬编码中文，优先读取技能目录下的 translate.json 本地字典，字典中没有的条目调用在线翻译 API，最终生成 zh.json 和 en.json，避免手动整理的误差。
i18n-ng-zorro：聚焦 NG-ZORRO 组件适配，修改 shared.module.ts 添加 NZ_I18N provider（如 { provide: NZ_I18N, useValue: zh_CN }），确保语言切换时组件文案同步更新。
i18n-migration：针对老项目提供分步改造指南，涵盖依赖替换、模块配置、服务创建、硬编码中文替换等环节，降低改造风险。

适用边界与注意点

使用这套技能需严格遵循版本要求：Node.js 必须为 10.16.2（需通过 nvm 切换），ng-zorro-antd 需锁定 7.2.0，@ngx-translate 相关依赖需匹配 Angular 7 的版本。另外，translate.json 仅存在于技能目录中，作为翻译模板供脚本读取，无需复制到项目内。语言读取优先级为 localStorage 中的 translate 字段→浏览器默认语言→中文（zh）；翻译优先级为 translate.json 本地字典→在线 API→简单规则映射，使用时需注意字典的维护与更新。