必须执行Configure Display Language命令并选zh-cn后重启VS Code,仅安装中文语言包无效;locale.json需由该命令生成且内容严格为{"locale":"zh-cn"},路径须在用户级目录。

装完中文语言包,界面还是英文?不是插件没装对,而是没触发语言切换逻辑。
为什么装了 Chinese (Simplified) Language Pack 还是英文
这个插件(ID:ms-ceintl.vscode-language-pack-zh-hans)只是提供翻译资源,不自动启用。VS Code 默认仍读取 locale 配置项,而初始值是 "en"。装插件 ≠ 切语言,二者必须分开操作。
- 只装插件不改
locale:菜单、设置页、命令面板全英文 - 只改
locale但没装插件:VS Code 找不到对应翻译资源,回退到英文 - 装错插件(如
Chinese Language Packby 13xforever):新版 VS Code 1.80+ 直接忽略,界面无变化
Configure Display Language 命令失效怎么办
该命令本质是打开并编辑 locale.json,但有时因权限、路径错误或后台进程残留导致失败。此时手动写入更可靠。
- 先彻底关闭所有 VS Code 窗口,包括托盘/后台进程(Windows 查
Code.exe,macOS 查Electron) - 定位并编辑用户级
locale.json文件:
– 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) - 别写成
zh_CN、zh-hans、Chinese或zh——这些全无效
部分界面仍是英文的常见原因
官方语言包覆盖约 85% 的 UI,但以下位置默认不汉化,不是配置问题:
-
Git面板、终端(Integrated Terminal)本身是系统 shell,语言由 OS 决定,VS Code 不干预 - 某些插件(如
Prettier、GitLens)有独立语言配置项,需单独设gitlens.language等 - Remote-SSH / WSL 场景下,远程环境也需安装语言包 + 设置
locale.json - 用了第三方主题(尤其非默认暗色主题),可能强制继承英文样式;换回
Default Dark+测试可验证
企业环境或策略锁定 locale 的识别与绕过
如果右下角点击 locale 显示灰色不可编辑,或 settings.json 中该字段带锁图标,说明被组策略或环境变量覆盖。
- 检查是否设置了系统级环境变量:
VSCODE_LANG=en或LANG=en_US.UTF-8 - 在 VS Code 设置中搜索
locale,若字段不可编辑,大概率是策略锁定,手动改locale.json也无效 - 此时需联系 IT 管理员解除策略,或临时在启动时加参数:
code --locale=zh-cn
最常被忽略的是“没关干净”——后台进程还在跑,新窗口复用旧环境,看起来像没生效。验证是否真生效,唯一方式是任务管理器里确认 Code.exe 或 Electron 进程已退出,再全新启动。


















