离线安装 VSCode 中文包必须三步:1. 用 Extensions: Install from VSIX 命令安装官方 .vsix(发布者 MS-CEINTL,ID ms-ceintl.vscode-language-pack-zh-hans);2. 运行 Configure Display Language 选 zh-cn;3. 彻底杀进程后重启。其他方式均无效。

离线安装 VSCode 中文包,必须走 Extensions: Install from VSIX 命令 + Configure Display Language 手动选 zh-cn + 彻底杀进程重启,三步缺一不可;双击 .vsix、拖拽进窗口、复制到 extensions 目录,全部无效。
怎么拿到真正能用的 .vsix 文件
不能搜“VSCode 中文包下载”随便点网盘链接——90% 是过期或非官方版本。必须认准发布者 MS-CEINTL 和扩展 ID ms-ceintl.vscode-language-pack-zh-hans:
- 在联网机器上打开 https://marketplace.visualstudio.com/items?itemName=MS-CEINTL.vscode-language-pack-zh-hans,拉到页面最底部点 Download Extension,得到形如
MS-CEINTL.vscode-language-pack-zh-hans-1.118.20260915.vsix的文件 - 用
code --version查离线机 VSCode 版本(如1.118.0),确保 .vsix 文件名中的版本号匹配其主版本(^1.118.0) - 右键解压 .vsix,打开
package.json,确认"engines": {"vscode": "^1.118.0"}与本地一致;不匹配会静默失败
为什么双击或拖拽 .vsix 文件完全没反应
VSCode 自 1.70 起已禁用该机制:文件只是被复制到 ~/.vscode/extensions/(Linux/macOS)或 %USERPROFILE%\.vscode\extensions\(Windows),但不会注册扩展 ID、不触发语言资源加载流程,也不会写入激活状态。
- 现象是:扩展面板里搜
ms-ceintl.vscode-language-pack-zh-hans不显示“已启用”,右下角仍为en,设置页全英文 - 验证方式:按
Ctrl+Shift+X搜索该 ID,若没出现或状态不是“Enabled”,说明根本没装成功 - 补救:先点击扩展右上角
⋯ → Uninstall,再严格走命令面板重装
装完还是英文?关键在 locale.json 和进程清理
Configure Display Language 命令本质是生成或修正 locale.json,但它只写配置、不刷新 UI;仅点 Reload Window 无效,必须点 Restart 并确保所有后台进程退出。
- 路径必须准确:
Windows:%APPDATA%\Code\User\locale.json
macOS:$HOME/Library/Application Support/Code/User/locale.json
Linux:$HOME/.config/Code/User/locale.json - 文件内容只能是单行合法 JSON:
{"locale":"zh-cn"}(小写、连字符、英文双引号、UTF-8 无 BOM、无空格、无逗号结尾) - 务必杀干净进程:
Windows:任务管理器中结束所有Code.exe
macOS:活动监视器中结束所有Electron进程
Linux:pkill -f "Code Helper"和pkill -f "Electron"
远程开发环境要单独部署
本地装了中文包,对 SSH 或 WSL 远程窗口完全无效——远程机器上必须重复完整流程。
- 操作路径:
点击右下角状态栏SSH: xxx→Install 'Chinese (Simplified) Language Pack' in SSH: xxx→ 安装完成后运行Configure Display Language选zh-cn→ 点Restart - 若远程无图形界面,需手动写
locale.json:
Linux 远程:~/.vscode-server/data/Machine/locale.json
Windows 远程:%USERPROFILE%\AppData\Roaming\Code\User\locale.json - 别信“一次配置全局生效”——VSCode 的 locale 是 per-session 的,远程连接启动的是独立实例
最容易被忽略的是版本匹配和进程残留:.vsix 版本号错一位、后台 Code.exe 没杀干净、locale.json 多了个空格,都会导致界面卡在英文不动,且无任何提示。











