必须执行configure display language命令并重启,因插件仅提供翻译资源而不自动激活;vs code 1.70+仅认用户级locale.json文件,内容须为{"locale":"zh-cn"}且utf-8无bom。

装了官方中文语言包,界面还是英文——不是插件坏了,是 locale 配置没生效或路径错了。
Configure Display Language 命令点不了或没 zh-cn 选项
这是语言包未完成初始化的典型表现,常见于 VS Code ≥1.89 版本。v1.89+ 启用 Ozone 渲染后,会跳过旧版 locale 解析逻辑,且要求语言包版本 ≥1.89.2026052801。
- 打开扩展面板,检查
Chinese (Simplified) Language Pack for Visual Studio Code是否已启用,版本号是否 ≥1.89.2026052801 - 若版本过低:卸载后重装;若重装失败,手动删掉
%USERPROFILE%\.vscode\extensions\ms-ceintl.vscode-language-pack-zh-hans-*所有文件夹 - 命令面板输入
Configure Display Language后无响应?说明命令未注册,直接编辑locale.json更稳(路径见下一条)
locale.json 放错位置或格式不合法
VS Code 只读取用户级 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-hans、ZH-CN、"locale": "zh-cn",(末尾逗号)全部无效 - 别写进工作区目录(如
.vscode/locale.json),VS Code 不读它
点了 Restart 还是英文?检查这三处硬伤
重启失败往往不是操作问题,而是环境或覆盖策略干扰。
- 右下角状态栏显示
en就说明没生效——这不是“快好了”,是彻底没加载 - 别点
Developer: Reload Window,它不重载语言环境;必须点弹窗里的Restart(杀掉所有Code.exe或Electron进程后全新启动) - 企业网络或组策略可能设了
VSCODE_LANG=en环境变量,或通过策略锁死 locale;此时改locale.json也无效,需先解除策略 - 远程开发(WSL / Remote-SSH)需单独配置:在远程机器的
~/.vscode-server/data/Machine/xxx/locale.json里写入相同内容
菜单/设置是中文,但终端和调试控制台仍是英文
终端(Terminal)和调试控制台(Debug Console)是 Electron 独立子进程,不继承主窗口的 locale 设置,它们的语言由系统环境或启动参数决定。
- 本地终端输出(如
npm run dev)、编译器报错(如error: expected ';' before '}' token)永远是英文,无法靠语言包切换 - 第三方插件命令(如 Git: Commit)是否翻译,取决于插件作者是否提供本地化支持;微软官方插件基本都支持,小众插件大多只有英文
- 想让终端提示符显示中文?需修改系统 shell 的 locale(如 Linux/macOS 的
LANG=zh_CN.UTF-8),与 VS Code 无关
真正卡住人的,从来不是“找不到插件”,而是 locale.json 路径写错、格式多一个空格、重启时只点了 Reload、或者远程环境完全忘了配——这些细节一错,整个汉化就停在英文界面上不动了。











