必须用命令面板执行Extensions: Install from VSIX安装中文包,双击或拖拽无效;安装后须运行Configure Display Language选zh-cn并重启,或手动编辑locale.json为{"locale":"zh-cn"}并彻底终止所有VSCode进程再启动。

必须用 Install from VSIX,双击或拖拽 .vsix 文件无效
VSCode 自 1.70 版起已禁用直接加载 .vsix 的机制。双击文件或拖进窗口,只会把文件复制到 ~/.vscode/extensions/(Linux/macOS)或 %USERPROFILE%\.vscode\extensions\(Windows),但不会注册扩展 ID、不触发语言资源加载,也**不会出现在扩展列表里**。现象是:右下角仍显示 en,设置页、命令面板、调试视图全英文,且无任何错误提示。
可靠路径只有一条:Ctrl+Shift+P → 输入 Extensions: Install from VSIX → 选中下载好的 vscode-language-pack-zh-hans-*.vsix → 点 Install。
- 确认发布者是
MS-CEINTL,ID 是ms-ceintl.vscode-language-pack-zh-hans - 不要从百度网盘、第三方镜像站下载;应从官网页面拉到底部点
Download Extension - 若安装后在扩展面板搜不到该包,说明根本没注册成功,需先卸载再重试
Configure Display Language 命令必须手动执行,且值只能是 zh-cn
装完语言包 ≠ 界面变中文。真正控制 UI 显示语言的是 Configure Display Language 命令——它会生成或修正 locale.json,但**只写配置,不刷新界面**。很多人点了 zh-cn 却误点 Reload Window,结果白忙一场。
- 命令名必须输全:
Configure Display Language(大小写、空格都不能错) - 选项里只认
zh-cn(小写、短横线、无空格;zh_CN、zh-hans、Chinese全部无效) - 选完后必须点提示里的
Restart,不是Reload Window - 如果命令面板搜不到这个命令,说明语言包压根没装成功或未激活
手动改 locale.json 是最稳的兜底方式
当命令面板卡死、UI 崩溃、或批量部署时,直接编辑配置文件反而最可靠。VS Code 启动时优先读取 locale.json,它的优先级高于 settings.json 中的 locale 字段。
操作前务必彻底关闭所有 VS Code 进程:
- Windows:任务管理器杀光所有
Code.exe - macOS:活动监视器杀掉
Electron和Code Helper - Linux:
pkill -f "Code Helper"+pkill -f "Electron"
然后打开对应路径的 locale.json(UTF-8 编码、无 BOM):
- 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"},不能多空格、不能加逗号、不能写成 "zh-cn " 或 "zh_CN"。
远程开发环境要单独部署,本地装了没用
SSH 或 WSL 远程开发时,本地装的中文包对远程窗口完全无效。必须在目标机器上重复两步:Install from VSIX + Configure Display Language。
- 操作路径:点击右下角状态栏的
SSH: xxx→ 点Install 'Chinese (Simplified) Language Pack' in SSH: xxx - 安装完成后,同样运行
Configure Display Language并选zh-cn→Restart - 若远程机器无图形界面,可手动写入
locale.json,路径与本地一致 - 注意:远程环境的系统
LANG变量(如en_US.UTF-8)可能干扰语言包加载,必要时临时设为zh_CN.UTF-8
最容易被忽略的是进程残留和版本匹配——装完不生效,90% 不是因为配置写错了,而是后台还有 Code Helper 在跑,或者你拿 v1.92 的 .vsix 强装进了 v1.104 的 VS Code。版本不兼容时,VS Code 有时静默失败,连报错都不给。











