如何修改i18n Ally插件的默认提示语言？

Question

如何修改 i18n Ally 插件的默认提示语言？在使用 VS Code 的 i18n Ally 插件时，其界面提示和语言检测默认为英文，影响非英语开发者的使用体验。尽管插件支持多语言项目管理，但官方并未提供直接配置界面语言的选项。开发者常尝试通过修改 VS Code 的显示语言或调整插件配置文件（如 settings.json）中的 locale 字段来实现切换，但效果有限。当前版本下，插件本身的 UI 语言仍受限于 VS Code 的核心语言包与插件内部实现机制。如何在不修改源码的前提下，正确配置使 i18n Ally 的提示信息（如悬停提示、命令面板文字）切换为中文或其他目标语言？是否存在隐藏配置项或兼容性方案？

Answer 1

如何修改 i18n Ally 插件的默认提示语言？

1. 问题背景与常见误区

i18n Ally 是 VS Code 中广泛使用的国际化辅助插件，支持多语言键值提取、自动补全和语言文件导航。然而，尽管其功能强大，其用户界面（UI）提示信息如悬停文本、命令面板条目、错误提示等，默认以英文显示。

许多开发者误以为通过以下方式可更改插件语言：

• 修改 settings.json 中的 locale 字段
• 在插件设置中添加自定义 i18n-ally.language
• 更改项目根目录下的 .vscode/extensionSettings.json

但这些方法大多无效，因为 i18n Ally 的 UI 语言并非由插件自身独立控制，而是依赖于 VS Code 的核心语言环境与插件的本地化实现机制。

2. 技术原理分析：VS Code 插件本地化机制

VS Code 插件的 UI 语言受制于两个关键因素：

1. VS Code 应用语言（Display Language）：由 vscode:locale 控制，决定所有内置及第三方插件的显示语言。
2. 插件是否提供对应语言包：即使设置了中文，若插件未实现中文翻译，则回退至英文。

i18n Ally 当前版本（v3.x）并未内置完整的非英语语言资源包（如 nls.zh-CN.json），因此即使 VS Code 设置为中文，插件仍显示英文。

配置项	作用范围	对 i18n Ally 是否有效
VS Code 显示语言 (locale)	全局 UI	部分有效（仅限已本地化的插件）
settings.json 中的 i18n-ally.*	插件功能逻辑	无效（无语言配置项）
插件源码中的 nls 文件	插件 UI 翻译	有效但需修改源码
系统区域设置 (OS Locale)	间接影响	通常无效

3. 可行解决方案路径

在不修改插件源码的前提下，可通过以下三种层级逐步尝试：

3.1 方法一：强制设置 VS Code 显示语言为中文

这是最基础且必要的前提条件。执行以下步骤：

// 在 VS Code 命令面板（Ctrl+Shift+P）中输入：
Configure Display Language
// 选择 "zh-CN"
// 重启 VS Code

验证是否生效：查看菜单栏、侧边栏等是否已汉化。若未生效，需检查系统语言或安装中文语言包。

3.2 方法二：检查插件是否支持社区翻译

部分插件通过开源社区贡献翻译。访问 i18n Ally 的 GitHub 仓库：

• 仓库地址：https://github.com/lokalise/i18n-ally
• 查找路径：src/locales/ 或 package.nls*.json

截至 2024 年，该项目尚未包含完整的中文语言包，因此官方层面无法直接启用中文 UI。

3.3 方法三：使用兼容性方案 —— 自定义语言覆盖（高级）

虽然不能直接修改插件源码，但可通过“扩展开发”模式创建一个补丁插件，覆盖原始插件的语言资源。流程如下：

graph TD
            A[创建新插件项目] --> B[引用 i18n Ally 插件ID]
            B --> C[提供 zh-CN 语言包 nls.zh-CN.json]
            C --> D[重写命令和提示文本]
            D --> E[发布为本地插件]
            E --> F[禁用原插件提示冲突]

该方法技术门槛高，适用于企业级定制环境，普通开发者建议关注官方更新。

4. 替代方案与未来展望

对于急需中文体验的团队，可考虑：

• 使用其他支持中文的 i18n 插件（如 Internationalization Assistant）
• 向 i18n Ally 提交 Feature Request，推动社区支持多语言 UI
• 基于 fork 版本自行维护中文语言包

随着 VS Code 插件生态对全球化支持的加强，未来有望通过 contributes.languages 和 l10n API 实现更灵活的语言切换机制。

5. 验证与调试技巧

在排查语言显示问题时，可使用以下命令辅助诊断：

// 查看当前语言环境
Developer: Inspect Context Keys

// 检查插件激活状态
Developer: Show Running Extensions

// 输出插件日志
i18n Ally: Open Output Channel

同时监控 ~/.vscode/extensions/lokalise.i18n-ally-* 目录下是否存在语言资源文件。