VSCode不支持离线安装多个版本中文包,仅能安装与当前版本严格匹配的单一语言包;需按目标机VSCode版本下载对应vsix,正确配置locale.json路径、UTF-8无BOM编码,并彻底重启进程。

离线安装多个版本中文包根本不可行
VSCode 不支持同时启用多个语言包,更不支持“多个版本共存”。所谓“装多个版本”,实际是误操作:重复安装不同 vscode-language-pack-zh-hans-*.vsix 文件,只会覆盖前一个,或触发版本冲突报错。VSCode 启动时只读取一个激活的语言包 ID(ms-ceintl.vscode-language-pack-zh-hans),并匹配当前 locale 配置值——它不认版本号,只认扩展是否已注册、是否兼容当前 VSCode 主程序。
为什么你会想装“多个版本”?常见误解场景
你遇到的通常不是真需要多版本,而是以下三种情况之一:
- VSCode 升级后旧版中文包失效(比如从 1.92 升到 1.95+,1.92 的 .vsix 安装失败或界面残留英文)
- 在不同机器上部署,但没注意 VSCode 版本差异,随手复制了不匹配的 .vsix
- 看到
locale.json里写"zh-cn"没反应,以为换用"zh-hans"或"zh-CN"就能“切换版本”
这些都不是版本问题,而是安装路径或配置不匹配导致的静默失败。
正确做法:按目标机器 VSCode 版本精准匹配一个 .vsix
必须为每台离线机器单独准备对应版本的 vscode-language-pack-zh-hans-*.vsix,步骤如下:
- 在一台联网且 VSCode 版本与目标机完全一致的机器上,打开 VSCode →
Ctrl+Shift+P→ 输入Extensions: Install from VSIX - 访问 官方语言包页面,点击右上角 Download Extension(不要复制 URL 手动拼接,新版市场已屏蔽非标准下载)
- 下载得到的文件名形如
ms-ceintl.vscode-language-pack-zh-hans-1.95.0.vsix,确认末尾版本号(如1.95.0)与目标机Help → About中显示的版本一致 - 将该 .vsix 复制到离线机,通过命令面板安装 → 运行
Configure Display Language→ 选zh-cn→ 彻底退出所有Code.exe/Electron进程后再重启
容易被忽略的关键点
真正卡住人的从来不是“找不到包”,而是三个隐藏动作没做全:
-
locale.json必须放在用户级路径:%APPDATA%\Code\User\locale.json(Windows)、~/.config/Code/User/locale.json(Linux)、$HOME/Library/Application Support/Code/User/locale.json(macOS),不能放错位置 - 文件必须保存为 UTF-8 无 BOM 编码,编辑器里另存时要手动选;带 BOM 的
{"locale":"zh-cn"}会被 VSCode 完全忽略 - 安装后必须杀掉全部后台进程再重启——Windows 任务管理器里要清空所有
Code.exe,Linux/macOS 要执行pkill -f "Code Helper"和pkill -f Electron,否则新 locale 不加载


















