vscode-language-pack-zh-hans 不是插件开发依赖项，仅翻译编辑器 ui；插件内文本本地化需手动实现，如调用 vscode.l10n.t() 并提供 package.nls.json 和 package.nls.zh-cn.json 文件。
vscode-language-pack-zh-hans 是插件开发的依赖项吗？
不是。它只负责编辑器 UI 的翻译，对插件开发本身无任何影响。插件代码里的 vscode.window.showInformationMessage()、context.subscriptions.push() 等 API 行为完全不受语言包控制——你用英文写插件，装了中文包后界面变中文，但插件弹出的消息文字仍是你代码里写的英文字符串。
常见误解是以为装了这个包就能“自动汉化插件提示”，实际必须手动在插件中调用 vscode.l10n.t()（v1.86+）或使用 nls.localize()（旧版）做多语言适配。
- 插件内文本本地化需单独实现，和编辑器语言包无关
-
ms-ceintl.vscode-language-pack-zh-hans的 ID 只用于安装 UI 翻译资源，不参与插件编译或运行时逻辑 - 调试插件时看到的错误日志、断点提示、输出通道内容，语言取决于系统 locale 或终端环境，不是这个插件控制的
插件开发中怎么让自己的提示消息支持中英文切换？
从 VS Code v1.86 开始，官方推荐用 vscode.l10n.t() 替代硬编码字符串。它会自动读取插件目录下的 package.nls.json（英文主干）和 package.nls.zh-cn.json（中文翻译），按当前编辑器语言动态返回对应文案。
关键步骤：
- 在
package.json的contributes下声明"l10n": "./nls" - 创建
nls/package.nls.json（含英文键值对，如"hello": "Hello World"） - 创建
nls/package.nls.zh-cn.json（同结构，值为中文，如"hello": "你好世界"） - 代码中改用
vscode.l10n.t('hello')而非直接写字符串 - 打包前运行
vsce package --yarn，确保nls/目录被包含进 .vsix
注意：vscode.l10n.t() 返回的是字符串，不能直接传给 vscode.window.showErrorMessage() 的第二个参数（那是 modal 选项），容易报类型错误。
为什么插件激活后中文提示没生效，但 locale.json 明明是 zh-cn？
因为插件自身的本地化和编辑器 UI 本地化是两套独立系统。即使你把 %APPDATA%\Code\User\locale.json 改成 {"locale":"zh-cn"}，也只影响菜单、设置面板等 VS Code 自身界面，不影响你插件里调用 vscode.l10n.t() 的行为——后者依赖的是插件包内是否提供对应语言文件，以及用户是否安装了该语言的 vscode-language-pack-zh-hans（仅作参考，非必需）。
排查重点：
- 检查插件源码是否真的调用了
vscode.l10n.t()，而不是拼接字符串 - 确认
nls/package.nls.zh-cn.json文件存在且 JSON 格式合法（无中文逗号、多余逗号） - 打开开发者工具（
Help > Toggle Developer Tools），看 Console 是否报Could not load localized strings类错误 - 插件发布后，用户必须安装你的插件 + 对应语言包（如需）才能看到翻译；仅改 locale.json 不起作用
离线环境下如何验证插件中文提示是否正常？
离线验证的关键是绕过网络加载语言包的环节，直接靠插件内置资源兜底。最可靠的做法是：在开发机上完成打包（vsce package），解压生成的 .vsix 文件，确认 nls/ 目录已包含 package.nls.json 和 package.nls.zh-cn.json，然后在目标离线机器上用 code --install-extension your-plugin.vsix 安装。
此时无需安装 ms-ceintl.vscode-language-pack-zh-hans，只要编辑器 locale 是 zh-cn，vscode.l10n.t() 就会优先读取插件内建的 .zh-cn.json 文件。
容易忽略的一点：VS Code 启动时若检测不到网络，可能跳过语言包初始化流程，导致 l10n 模块未就绪。建议在 activate() 中加一层判断：
if (vscode.l10n) {
vscode.window.showInformationMessage(vscode.l10n.t('hello'));
} else {
vscode.window.showInformationMessage('Hello World'); // fallback
}
