离线安装vscode中文包必须通过命令面板执行“extensions: install from vsix”,双击或拖拽.vsix文件无效;安装后须运行“configure display language”选zh-cn并彻底重启进程。

离线安装必须用 Extensions: Install from VSIX,双击.vsix文件无效
VSCode 自 1.70 版起已禁用双击或拖拽 .vsix 文件的安装方式,静默失败且无提示。文件会被复制到 ~/.vscode/extensions/(Linux/macOS)或 %USERPROFILE%\.vscode\extensions\(Windows),但不会注册扩展 ID、不触发语言资源加载,界面仍为英文。
正确做法是:在离线机上打开 VSCode → 按 Ctrl+Shift+P → 输入 Extensions: Install from VSIX → 回车 → 选中提前下载好的 MS-CEINTL.vscode-language-pack-zh-hans-*.vsix 文件 → 点 Install。
- 务必认准发布者为
MS-CEINTL,ID 为ms-ceintl.vscode-language-pack-zh-hans - 不要手动解压 .vsix 后拷贝进
extensions目录——缺少.metadata注册记录,VSCode 启动时不识别 - 若扩展面板里搜不到该包或状态不是“已启用”,说明未真正安装,需先
Uninstall再重试
Configure Display Language 必须手动执行,且只认 zh-cn
装完语言包 ≠ 界面变中文。这个命令才是激活开关,它会写入或修正 locale.json,但仅写配置,不刷新 UI。
操作路径:Ctrl+Shift+P → 输入 Configure Display Language → 回车 → 在弹出列表中**明确选 zh-cn**(小写、连字符、无空格;zh_CN、zh-hans、Chinese 全无效)→ 点提示中的 Restart(不是 Reload Window)。
- 如果命令面板搜不到
Configure Display Language,说明语言包根本没注册成功,重走 Install from VSIX 步骤 -
zh-hans在 1.95+ 版本中仅加载部分字符串,设置页、调试面板等关键区域仍为英文 - 选错后
locale.json可能已存错误值,需手动清理再重试
重启必须彻底杀进程,否则 locale.json 不生效
Restart 提示点完后,若界面仍是英文,大概率是后台残留进程干扰了语言资源加载。
必须彻底关闭所有 VSCode 窗口,并杀光相关进程:
- Windows:打开任务管理器 → 结束所有
Code.exe进程 - macOS:活动监视器 → 结束所有
Electron和Code Helper进程 - Linux:终端运行
pkill -f "Code Helper"和pkill -f "Electron"
之后再全新启动 VSCode —— 不要双击旧快捷方式(可能指向卸载过的老版本路径),改从「开始菜单」或「应用坞」打开。
手动写 locale.json 是最后兜底方案
当命令面板卡死、UI 崩溃或批量部署时,直接编辑配置文件最可靠。VSCode 启动时优先读取 locale.json,它的优先级高于 settings.json 中的 locale 字段。
路径和内容必须严格匹配:
- 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、无多余空格或逗号)
别往 settings.json 里加 "locale": "zh-cn" —— 这个字段在那里不被识别。也别试图用 code --install-extension 命令行安装,它在离线环境下对路径、权限、架构极其敏感,容易报 ENOENT 或 Extension is not compatible。











