离线重装 VSCode 中文包需三步:彻底卸载旧包(用命令行或手动删目录并清理 locale.json)、通过命令面板 Install from VSIX 安装 .vsix、手动设 locale.json 为 {"locale":"zh-cn"} 并杀净所有 Code/Electron 进程。

离线重装 VSCode 中文包,核心就三件事:彻底卸载旧包、用正确方式重装 .vsix、手动设 zh-cn 并杀净后台进程——漏掉任一环,界面都还是英文。
为什么卸载不干净会导致重装失败
VSCode 自 1.70 起把语言包注册和资源加载拆开管理。只删扩展面板里的条目,或只删 ~/.vscode/extensions/ 下对应目录,ms-ceintl.vscode-language-pack-zh-hans 的 ID 仍可能残留在内部注册表里,导致新装的 .vsix 被跳过激活流程。
- 现象:重装后右下角仍显示
en,命令面板搜不到Configure Display Language - 根本原因:旧语言包未真正注销,VSCode 认为“已有同名包”,拒绝加载新资源
- 必须连带清理:
locale.json文件(它可能还存着错误值)、所有残留的Code.exe或Electron进程
离线卸载:不能只点“Uninstall”
扩展面板里点 … → Uninstall 只是软卸载,不清理注册状态。要硬清,得走命令行或手动删文件。
- 先关闭所有 VSCode 窗口,再执行:
code --uninstall-extension ms-ceintl.vscode-language-pack-zh-hans - 若命令行不可用(比如没加 PATH),就手动删目录:
Windows:%USERPROFILE%\.vscode\extensions\ms-ceintl.vscode-language-pack-zh-hans-*
macOS/Linux:~/.vscode/extensions/ms-ceintl.vscode-language-pack-zh-hans-* - 删完立刻检查并删除
locale.json(路径见下一条),避免它残留错误配置
重装必须用 Extensions: Install from VSIX
双击 .vsix、拖进窗口、code --install-extension 命令,在 1.70+ 版本里都可能静默失败——它们绕过了 VSCode 的扩展注册器,只复制文件不激活。
- 正确操作:按
Ctrl+Shift+P→ 输入Extensions: Install from VSIX→ 选中你下载好的vscode-language-pack-zh-hans-*.vsix(发布者必须是MS-CEINTL)→ 点Install - 安装成功后,扩展面板里应看到
Chinese (Simplified) Language Pack for Visual Studio Code,状态为“已启用”,发布者是Microsoft - 别信右下角弹窗提示;如果没弹,不代表失败,但你要主动验证下一步
locale.json 必须写成 {"locale":"zh-cn"} 且 UTF-8 无 BOM
很多人卡在这步:装对了、也重启了,但设置页、调试面板还是英文。问题几乎全出在 locale.json 写错格式或路径不对。
- 路径必须精准:
Windows:%APPDATA%\Code\User\locale.json
macOS:$HOME/Library/Application Support/Code/User/locale.json
Linux:$HOME/.config/Code/User/locale.json - 文件内容只能有一行,严格如下:
{"locale":"zh-cn"}
注意:双引号、小写、短横线、无空格、无逗号、无注释、UTF-8 编码且无 BOM - 写完后,必须彻底杀进程再启动:
Windows:任务管理器结束所有Code.exe
macOS:活动监视器结束所有Electron
Linux:pkill -f code
最容易被忽略的是进程残留——哪怕只留一个 Code.exe 后台进程,VSCode 就会复用旧状态,locale.json 的新值压根不读。重装不是“换文件”,而是“换上下文”。


















