离线安装vscode中文包需先用命令“extensions: install from vsix”安装,再执行“configure display language”并选zh-cn后重启;手动编辑locale.json(内容{"locale":"zh-cn"})为兜底方案;远程开发须在目标机重复操作。

离线安装 VSCode 官方中文包,不是把 .vsix 文件双击或拖进窗口就能生效——它会静默失败,界面依然英文,且无任何报错提示。
必须用 Extensions: Install from VSIX 命令安装
VSCode 自 1.70 版起已禁用直接加载 .vsix 的机制。双击、拖拽、甚至手动复制到 ~/.vscode/extensions/ 目录,都只是把文件存进去,不注册扩展 ID,也不触发语言资源加载。
- 正确操作:按
Ctrl+Shift+P(Windows/Linux)或Cmd+Shift+P(macOS),输入Extensions: Install from VSIX,回车,再选中你提前下载好的MS-CEINTL.vscode-language-pack-zh-hans-*.vsix文件 - 验证是否成功:打开扩展面板(
Ctrl+Shift+X),搜索ms-ceintl.vscode-language-pack-zh-hans,确认状态为“已启用” - 常见失败现象:右下角仍显示
en、设置页/命令面板全英文、扩展列表里找不到该包——说明根本没注册,需先Uninstall再重试
Configure Display Language 必须手动执行并选 zh-cn
装完语言包 ≠ 界面变中文。Configure Display Language 是唯一能激活语言资源的开关,它会生成或修正 locale.json,但只写配置,不刷新 UI。
- 操作路径:再次按
Ctrl+Shift+P→ 输入Configure Display Language→ 从下拉列表中**明确选择zh-cn**(小写、短横线、无空格;zh_CN、zh-hans、Chinese全部无效) - 选完后必须点提示里的
Restart,不是Reload Window—— 后者只重载插件逻辑,不加载语言资源 - 如果命令面板搜不到
Configure Display Language,说明语言包压根没注册成功,不是配置问题,而是安装步骤没走对
locale.json 手动写入是最后兜底手段
当命令面板卡死、UI 崩溃或批量部署时,直接编辑 locale.json 最可靠。它的优先级高于 settings.json 中的任何 locale 设置。
- 先彻底退出所有 VSCode 进程:Windows 杀光所有
Code.exe,macOS/Linux 执行pkill -f "Code Helper"和pkill -f "Electron" - 定位并新建/覆盖该文件:
– 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、无多余空格或逗号)
真正容易被忽略的是:离线环境常搭配远程开发(如 SSH/WSL),本地装的包对远程窗口完全无效——必须在目标机器上重复上述两步(Install from VSIX + Configure Display Language),且远程的 locale.json 路径与本地不同(如 Linux 远程是 ~/.vscode-server/data/Machine/locale.json)。











