vscode离线安装中文包必须用命令面板执行extensions: install from vsix并选zh-cn后彻底重启,双击拖拽.vsix、手动复制文件夹或code --install-extension均无效;需下载ms-ceintl发布的vscode-language-pack-zh-hans-*.vsix,校验版本匹配,编辑locale.json为{"locale":"zh-cn"},并杀净后台进程。

VSCode 离线安装中文包,不能靠解压后复制文件夹,必须用 Extensions: Install from VSIX 命令走完整注册流程——否则界面永远是英文,且扩展面板里不显示已启用状态。
怎么下载真正能用的 vscode-language-pack-zh-hans.vsix
只认官网发布者 MS-CEINTL,其他名字带“汉化”“中文支持”的插件一律跳过。正确路径是打开 VS Code 官网语言包页面,拉到最底部点 Download Extension,得到形如 MS-CEINTL.vscode-language-pack-zh-hans-1.104.2025082016.vsix 的文件。
- 右键解压这个
.vsix(它本质是 zip),打开里面的package.json,确认"engines": {"vscode": "^1.104.0"}和你本地code --version输出的主版本号一致(比如输出1.104.2,就匹配^1.104.0) - 别用百度搜出的网盘链接、exe 封装器或第三方镜像站——过期率高,还可能带静默行为
- 下载后文件名不含
MS-CEINTL或发布者不是MS-CEINTL,直接丢弃
为什么不能手动解压 + 复制到 extensions 文件夹
VS Code 启动时只扫描 extensions 目录下已注册、已解压、有 .metadata 记录的扩展。手动拷贝解压后的文件夹(比如从别人电脑上直接复制 ms-ceintl.vscode-language-pack-zh-hans-1.104.2 整个文件夹过来),VS Code 不识别,也不写入激活状态,现象是:扩展面板里搜不到、右下角语言标识仍是 en、命令面板里 Configure Display Language 根本不出现。
- 双击
.vsix文件也不行:VS Code 自 1.70 起禁用该机制,只是把文件丢进 extensions 目录,不注册 ID、不加载资源 -
code --install-extension xxx.vsix命令在离线环境也可能静默失败,不推荐作为首选 - 唯一可靠路径:VS Code 内部执行
Extensions: Install from VSIX
locale.json 必须严格写成 {"locale":"zh-cn"}
装完 .vsix 只是铺好了翻译资源,真正切换语言靠的是 locale.json 配置。这个文件必须放在用户级配置路径,内容一字不能错:
- Linux:
~/.config/Code/User/locale.json - Windows:
%APPDATA%\Code\User\locale.json - macOS:
$HOME/Library/Application Support/Code/User/locale.json - 内容只能是
{"locale":"zh-cn"}(小写、连字符、双引号、UTF-8 无 BOM 编码) - 写成
zh_CN、ZH-CN、zh-hans或带空格的"zh-cn ",VS Code 会直接忽略该字段
重启前必须杀干净后台进程
很多人点了 Restart Now 还是英文,是因为旧进程没退出干净。VS Code 的语言资源是在主进程启动时加载的,残留的 Code Helper 或 Electron 进程会锁住旧配置。
- Windows:任务管理器中结束所有
Code.exe进程 - macOS/Linux:终端执行
pkill -f "Code Helper"和pkill -f "Electron" - 再重新启动 VS Code,此时右下角应显示
zh-cn,设置页、调试面板、终端标题栏全为中文
最容易被忽略的是版本匹配和进程清理——哪怕 .vsix 下载对了、locale.json 写对了,只要本地 code --version 是 1.105.0 而你装的是 1.104.x 的包,或者后台还有 Code Helper 在跑,中文就不会生效。











