vscode中文界面失效的最常见原因是装错第三方插件;必须安装微软官方语言包ms-ceintl.vscode-language-pack-zh-hans,执行configure display language命令选择zh-cn并彻底重启,且locale.json内容须严格为{"locale":"zh-cn"}。

装错插件是中文界面失效的最常见原因
VSCode 不会因为你搜“中文”“汉化”“简体”就自动装对包。第三方插件常带广告、乱码、甚至篡改主页,且根本不会翻译菜单或命令面板。只认一个扩展:Chinese (Simplified) Language Pack for Visual Studio Code,发布者必须是 Microsoft,ID 是 ms-ceintl.vscode-language-pack-zh-hans。
操作时注意:
- 按
Ctrl+Shift+X(Windows/Linux)或Cmd+Shift+X(macOS)打开扩展面板 - 搜索关键词严格用
Chinese (Simplified)(注意括号、空格、大小写) - 别输
chinese lang、zh-cn或汉化——这些会命中大量非官方插件 - 安装后右下角弹出 Restart Now,必须点它;
Reload Window不生效
Configure Display Language 命令没反应?说明语言包根本没装上
这个命令本质是修改 locale.json 文件里的 "locale" 字段。如果按 Ctrl+Shift+P 输入 Configure Display Language 后无响应、列表为空、或点了没变化,基本可断定语言包没成功安装或未启用。
验证方式:
- 再开命令面板,输入
Extensions: Show Installed Extensions - 检查
ms-ceintl.vscode-language-pack-zh-hans是否在列表中且状态为 Enabled - 若不在,重装;若在但禁用,手动启用
- 装完仍无效?关掉所有 VS Code 进程(Windows 查任务管理器里的
Code.exe,macOS 查Electron),再启动
locale 配置必须写成 "zh-cn",其他写法全无效
VSCode 只接受严格符合 BCP 47 标准的小写连字符格式。哪怕只错一个字符,都会回退到英文界面。这不是容错问题,是硬性校验逻辑。
错误示例(全部不工作):
-
"locale": "zh_CN"(下划线不是连字符) -
"locale": "zh-hans"(虽是合法 locale,但 VSCode 当前不识别) -
"locale": "Chinese"或"locale": "zh"(非标准标识符)
正确写法只有一种:"locale": "zh-cn"。它必须出现在 locale.json 中(不是 settings.json),路径通常为:$HOME/.vscode/locale.json(macOS/Linux)或 %USERPROFILE%\AppData\Roaming\Code\locale.json(Windows)。
装完重启后菜单仍是英文?检查后台进程是否残留
很多人点了 Restart Now 却发现界面没变,是因为 VSCode 的 Electron 主进程没真正退出。尤其在 Windows 上,Code.exe 常驻后台,新窗口只是复用旧进程,语言配置不会刷新。
彻底重启的关键动作:
- 关闭所有 VSCode 窗口
- Windows:打开任务管理器 → 结束所有
Code.exe进程 - macOS:打开 Activity Monitor → 搜索
Electron→ 强制退出所有相关进程 - Linux:终端执行
pkill -f "code --no-sandbox"或类似命令 - 再手动双击图标启动,而非从旧窗口 Reload
这一步被跳过,90% 的“装了中文包却还是英文”问题都不会解决——语言包和配置都对,但进程没换,资源加载还是旧的。











