VS Code插件locale读取失效应主动读取配置而非依赖vscode.env.language，推荐用vscode-nls实现多语言，禁用第三方汉化插件以避免冲突，终端/调试器需单独配置locale。
插件开发时 locale 读取失效怎么办
VS Code 插件无法自动感知编辑器当前语言，vscode.env.language 返回的是系统语言（如 en-us），不是用户设置的 locale。这导致中文界面下插件仍显示英文文案，尤其在自定义提示、状态栏文字、命令面板描述中明显。
正确做法是主动读取配置项而非依赖环境变量：
- 在插件激活函数
activate()中调用vscode.workspace.getConfiguration().get('locale')，但注意该值需用户手动设在settings.json里，非默认项 - 更可靠的方式是监听
vscode.env.language+ 检查vscode.workspace.getConfiguration('locale').get('language')（VS Code 1.82+ 新增的配置路径） - 若两者都为空或为
en，再 fallback 到navigator.language（仅限 Web 版插件）
中文文案硬编码 vs 多语言资源包
直接在代码里写 "保存成功" 看似简单，但会导致插件无法适配英文用户、无法参与 VS Code 语言包统一更新、且违反 Microsoft Store 审核规范（要求支持至少 en-us 和用户 locale）。
推荐使用官方 vscode-nls 工具链：
- 安装
@vscode/nls，把字符串提取到nls.default.json和对应nls.zh-cn.json - 构建时运行
nls-dev命令生成package.nls.json，它会被 VS Code 自动加载 - 注意：插件发布后，用户切换
locale时，vscode-nls会自动匹配对应翻译文件，无需重启插件 - 错误示例：
vscode.window.showInformationMessage('操作已完成')→ 应改为vscode.window.showInformationMessage(localize('done', '操作已完成'))
调试器/终端等子模块仍是英文
即使主界面汉化完成，调试控制台、集成终端、任务输出面板仍可能显示英文。这不是插件问题，而是这些组件由独立进程托管（如 ptyhost.exe 或 node 子进程），它们不继承 VS Code 的 locale 设置。
解决路径有限但明确：
- 终端：在
settings.json中设置"terminal.integrated.env.windows": {"LANG": "zh_CN.UTF-8"}（仅 Windows 有效，Linux/macOS 需改系统 locale） - 调试器：检查所用调试扩展（如
ms-vscode.cpptools）是否自带中文资源；若无，则其 UI 文字（如断点面板标题）无法被 VS Code 主 locale 覆盖 - 任务输出：确保脚本自身输出中文（如
echo "编译完成"），VS Code 只负责渲染，不翻译 stdout
插件启用后中文界面卡顿或崩溃
常见于同时启用多个汉化类插件（如 Chinese Menu + vscode-zh-hans-menu + 官方语言包），它们都在劫持 DOM 节点并重写文本，造成样式冲突与重绘风暴。
必须做减法：
- 只保留官方
ms-ceintl.vscode-language-pack-zh-hans—— 它通过 VS Code 内置 i18n 机制工作，性能最优 - 禁用所有第三方“菜单汉化”插件，它们本质是 DOM 注入脚本，VS Code 1.80+ 已限制此类行为，易触发安全警告甚至被强制卸载
- 若真需补全汉化，优先修改
locale.json手动映射（如{"debug.start": "开始调试"}），比插件更轻量、更可控
插件开发中真正难的不是翻译本身，而是判断哪些文本该由插件自己管、哪些该交给 VS Code 的全局 locale 机制——混用就会出事。
