必须用 extensions: install from vsix 命令安装中文包,再执行 configure display language 并选 zh-cn 重启,或手动编辑 utf-8 无 bom 的 locale.json 为 {"locale":"zh-cn"}。

离线安装 VSCode 中文包,不能靠双击 .vsix、拖拽文件或手动复制到 extensions 目录——这些操作在 VSCode 1.70+ 版本中全部静默失败,界面不会变中文,且无任何提示。
必须用 Extensions: Install from 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文件(认准发布者是MS-CEINTL,ID 是ms-ceintl.vscode-language-pack-zh-hans) - 点击
Install,等待完成(右下角可能弹出“Language changed to Chinese (Simplified)”提示) - 安装后务必检查扩展面板:搜索
ms-ceintl.vscode-language-pack-zh-hans,确认状态为“已启用”
Configure Display Language 必须手动触发
语言包只是“字典”,真正告诉 VSCode “用中文显示”的动作是 Configure Display Language 命令。它不是自动运行的,也不会在安装后默认激活。
- 按
Ctrl+Shift+P→ 输入Configure Display Language(注意大小写和空格,不能缩写) - 从下拉列表中**严格选择
zh-cn**(不是zh_CN、zh-hans、Chinese或留空) - 点提示里的
Restart—— 不是Reload Window,后者只重载插件,不刷新语言资源 - 如果命令面板里搜不到该命令,说明语言包根本没装成功,或安装后未重启过任何窗口
locale.json 手动编辑是离线环境最稳兜底方案
当命令面板打不开、UI 卡死、或批量部署时,直接改配置文件比依赖 UI 更可靠。VSCode 1.70+ 只读用户级 locale.json,且格式稍有偏差就静默回退英文。
- 先彻底关闭所有 VSCode 进程:
– Windows:任务管理器杀掉全部Code.exe
– macOS:活动监视器杀掉Electron和Code Helper
– Linux:pkill -f "Code Helper"+pkill -f "Electron" - 用 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"}(无空格、无逗号结尾、双引号必须是英文符号) - 保存后全新启动 VSCode,不要复用旧进程
容易被忽略的三个失效根源
90% 的“装完还是英文”问题,和语言包本身无关,而是环境残留或配置冲突。
-
code --version输出的版本号(如1.104.2)必须与.vsix文件名中的主版本匹配(如vscode-language-pack-zh-hans-1.104.2.vsix)。不匹配会静默失败或报Extension is not compatible - Windows 系统区域若设为
English (United States)且勾了「Beta: Use Unicode UTF-8 for worldwide language support」,VSCode 会跳过语言包加载;macOS/Linux 下运行echo $LANG若为en_US.UTF-8,需临时export LANG=zh_CN.UTF-8再启 VSCode - 旧快捷方式可能指向已卸载的老版 VSCode 路径;务必从「开始菜单」或「应用坞」重新打开,避免复用残留进程











