vscode中文界面需安装微软官方插件ms-ceintl.vscode-language-pack-zh-hans,执行configure display language命令将locale.json设为"zh-cn",并彻底重启进程;仅装插件或仅重载窗口无效。

安装中文语言包必须认准 Microsoft 官方插件
VS Code 的简体中文支持只来自一个可靠来源:ms-ceintl.vscode-language-pack-zh-hans(插件 ID),对应扩展市场里显示为 Chinese (Simplified) Language Pack for Visual Studio Code,发布者必须是 Microsoft。搜 chinese 或 zh-hans 会混入大量非官方、已停更、甚至带广告的第三方“汉化补丁”,它们无法随 VS Code 升级同步更新,还可能覆盖核心语言资源导致菜单错乱或命令面板空白。
正确操作路径:
- 按
Ctrl+Shift+X打开扩展面板 - 搜索
Chinese (Simplified) Language Pack for Visual Studio Code - 确认右上角作者栏写的是
Microsoft,图标含蓝白 VS 标志 - 点击 Install,完成后务必点右下角弹出的
Restart Now—— 仅 Reload Window 不生效
Configure Display Language 命令失效的三种真实原因
这个命令本质是修改 locale.json 文件。如果执行后无反应、列表为空、或选了 zh-cn 仍不生效,大概率不是命令坏了,而是底层配置没到位:
-
locale.json文件根本不存在:新版 VS Code 默认不生成该文件,需手动创建或改settings.json - 插件未真正安装成功:在扩展面板搜
@installed,确认列表中存在且状态为Installed - 配置被覆盖:企业策略、某些主题插件(如
vscode-theme-onedark的旧版)、或工作区.vscode/settings.json中的"locale"项会优先于用户设置,但工作区设置对界面语言无效
更稳的做法是直接打开 settings.json(Ctrl+Shift+P → Open User Settings (JSON)),添加一行:"locale": "zh-cn"。注意必须是双引号、小写、短横线,不能写成 zh_CN 或 zh-hans(后者在部分 1.7x 旧版可用,但 1.80+ 已统一要求 zh-cn)。
改完配置还是英文?重启 ≠ 重载窗口
VS Code 只在**进程启动时读取一次 locale 配置**。运行中修改 settings.json、或只点 Developer: Reload Window,界面语言完全不会变。
必须彻底退出所有 VS Code 进程:
- Windows:关掉所有窗口后,打开任务管理器 → 结束所有
Code.exe进程(包括后台服务进程) - macOS:活动监视器中查找
Electron或Code Helper,全部强制退出 - Linux:终端执行
pkill -f "code --no-sandbox"或类似命令
再重新启动 VS Code,才能让新 locale 生效。很多用户卡在这一步,反复改配置却始终看到英文菜单。
中文界面不全?这不是 bug,是设计限制
官方语言包对 UI 的覆盖率约 85%,以下模块默认保持英文,属正常行为:
- 集成终端(Terminal)中的 shell 输出(如
npm install日志、git status提示) - 调试控制台(Debug Console)里的变量类型、错误堆栈(如
TypeError: Cannot read property 'map' of undefined) - 部分第三方插件的界面(如 Live Server 的右下角状态栏文字)
想补全右键菜单或设置项翻译,可额外装社区插件:Chinese Menu 或 vscode-zh-hans-menu,但它们不改变核心语言逻辑,也不参与 VS Code 官方更新链。终端和调试输出的英文无法通过插件切换——那是操作系统/运行时环境决定的,不是编辑器能控制的。











