必须使用官方语言包ms-ceintl.vscode-language-pack-zh-hans,第三方中文包因vs code 1.85+移除支持而失效,安装后界面仍英文;离线安装须通过命令面板执行extensions: install from vsix,并配置locale为zh-cn后彻底重启验证。

不能安全离线安装第三方中文包——官方已不支持,且存在运行时失效、UI残留英文、甚至插件冲突风险。
为什么“第三方中文包”基本等于无效包
VS Code 自 1.85 版起彻底移除了对非官方语言包的 vs/nls.js 加载支持。第三方包(如发布者不是 MS-CEINTL、ID 不是 ms-ceintl.vscode-language-pack-zh-hans)通常缺少 contributes.localizations 声明或正确打包的 nls 资源目录,导致:
- 安装后扩展面板显示“已启用”,但右下角仍为
en - 命令面板提示、设置页、调试视图、侧边栏菜单全部维持英文
- 部分版本(如 1.95+)会静默跳过加载,连错误日志都不输出
- 若与官方包共存,VS Code 可能因 locale 冲突直接禁用全部语言资源
真正能离线安装的只有官方语言包
唯一被 VS Code 主程序硬编码识别的语言包 ID 是:ms-ceintl.vscode-language-pack-zh-hans,发布者必须是 MS-CEINTL。其他任何变体(chinese-lang-pack、vscode-chinese、zh-cn-lang 等)均不参与内部 locale 协商流程。
验证方式:安装后打开扩展面板,搜索 ms-ceintl.vscode-language-pack-zh-hans,确认状态为“已启用”且版本号与本地 code --version 输出的主版本匹配(如 1.90.2 → 需用 1.90.x 的 vsix)。
离线安装必须走命令面板,双击/拖拽/命令行全不可靠
VS Code 自 1.70 起禁用文件系统直读机制。双击 .vsix 或拖入窗口仅复制文件到 ~/.vscode/extensions/,但不注册扩展 ID、不触发资源绑定、不写入激活状态。
正确路径只有一条:
- 按
Ctrl+Shift+P(macOS 为Cmd+Shift+P) - 输入并执行
Extensions: Install from VSIX - 在弹出框中选择已下载的
MS-CEINTL.vscode-language-pack-zh-hans-*.vsix文件 - 点击
Install,等待提示“Installation completed”
装完不等于生效——必须再执行 Configure Display Language 并明确选 zh-cn(注意小写、短横线),然后点 Restart(不是 Reload Window)。
验证是否真生效,只看这三处
别信终端、Git 提示、右下角状态栏——它们不走 VS Code 的 locale 配置。
真正有效的验证点只有:
- 顶部菜单栏(File / Edit / View…)是否全中文
- 命令面板(
Ctrl+Shift+P)里输入关键词,提示文字是否中文 - 设置页面(
Ctrl+,)左侧导航栏(Settings / Extensions / Keyboard Shortcuts…)是否中文
三处全中,才算部署成功;任一为英文,说明语言包未加载或配置被覆盖。最常被忽略的是后台残留进程:Windows 上需杀光所有 Code.exe,macOS/Linux 上执行 pkill -f "Electron" 后再重启。











