vscode离线安装中文包必须通过命令面板执行“extensions: install from vsix”安装官方vsix包,再运行“configure display language”选zh-cn并彻底重启;双击、拖拽、重命名或手动复制文件均无效,因vscode自1.70起禁用直载机制,且仅认package.json中id为ms-ceintl.vscode-language-pack-zh-hans及locale.json中{"locale":"zh-cn"}的配置。

VSCode离线安装中文包必须用命令面板,不是改文件名
直接双击或重命名 .vsix 文件(比如改成 zh-cn.vsix)完全无效——VSCode 自 1.70 版起已禁用文件系统直载机制。它不会注册扩展 ID,不加载语言资源,也不写入激活状态。现象是:右下角仍显示 en,设置页、命令面板、调试视图全英文,且无任何错误提示。
语言包文件名本身不重要,关键在 package.json 和 locale.json
VSCode 不校验 .vsix 文件名,只认内部结构和用户配置。真正起作用的有两处:
-
package.json中的"id": "ms-ceintl.vscode-language-pack-zh-hans"必须匹配官方发布者(否则不识别为语言包) - 用户级
locale.json内容必须严格为{"locale":"zh-cn"}(小写、连字符、UTF-8 无 BOM) - 路径必须正确:
– Windows:%APPDATA%\Code\User\locale.json
– macOS:$HOME/Library/Application Support/Code/User/locale.json
– Linux:$HOME/.config/Code/User/locale.json
手动改名 .vsix 文件反而容易出错
常见翻车点包括:
- 用 Windows 右键“重命名”改后缀(如
xxx.zip → xxx.vsix),可能触发杀毒软件重写或加双后缀(xxx.vsix.zip),导致unzip -t校验失败 - 把官方
vscode-language-pack-zh-hans-1.95.0.vsix改成zh-cn.vsix,虽不影响安装,但混淆版本管理,后续升级或排查兼容性时无法对应 - 误删
.vsix内部文件(如extension/package.json或translations/zh-cn.xlf),VSCode 直接拒绝加载,报错Extension is not a valid VS Code extension
离线部署唯一可靠流程
别碰文件名,按顺序走这三步:
- 从官网下载完整未损坏的
vscode-language-pack-zh-hans-*.vsix(认准发布者MS-CEINTL,ID 是ms-ceintl.vscode-language-pack-zh-hans) - VSCode 中按
Ctrl+Shift+P→ 输入Extensions: Install from VSIX→ 选中该文件 → 点Install - 安装完成后,再执行
Configure Display Language→ 选zh-cn→Restart
最后检查是否生效:重启后打开开发者工具(Ctrl+Shift+P → Developer: Toggle Developer Tools),Console 里应无 Failed to load locale 报错,且扩展面板中 ms-ceintl.vscode-language-pack-zh-hans 显示“已启用”。











