vscode显示中文界面必须同时满足三条件:安装微软官方中文语言包、执行configure display language命令选zh-cn、彻底重启;缺一不可。装错第三方插件或locale格式错误(如zh_cn、zh-cn)均无效,终端等子进程英文属正常现象。

VSCode 要显示中文界面,只靠装插件或改 settings.json 都不够——必须装对插件 + 运行 Configure Display Language 命令 + 彻底重启,三者缺一不可。
安装 Chinese (Simplified) Language Pack for Visual Studio Code 插件
这个插件是微软官方发布的唯一合法语言包,ID 是 ms-ceintl.vscode-language-pack-zh-hans,作者必须是 Microsoft。搜“中文”“汉化”“Chinese Menu”等关键词出来的第三方插件,全都不认、不兼容、容易报 Cannot read property 'translate' of undefined 错误。
- 按
Ctrl+Shift+X打开扩展面板,粘贴完整名称搜索(小写) - 认准蓝勾图标和 Microsoft 发布者
- 点安装后,右下角会弹出
Restart Now提示——必须点它,不能只点“重载窗口”
执行 Configure Display Language 命令选 zh-cn
插件只是“备好字典”,真正激活中文靠的是这条命令。它会自动生成或覆盖 locale.json,且只接受严格格式的 zh-cn(小写 + 连字符)。任何变体如 zh_CN、ZH-CN、zh、Chinese 全部无效,且无报错提示,界面就一直保持英文。
- 按
Ctrl+Shift+P打开命令面板,输入Configure Display Language(注意大小写和空格) - 从下拉列表中明确选择
zh-cn,不是“简体中文”文字项 - 弹窗提示“是否重启窗口”,必须点
Restart,不是Reload Window
手动编辑 locale.json 文件(命令面板失效时)
如果命令面板打不开、卡死,或选了 zh-cn 但重启后仍是英文,说明 VS Code 没读到配置。此时直接写 locale.json 是最稳兜底方式,它绕过 UI 层,强制指定语言。
- 先彻底退出 VS Code:Windows 查任务管理器杀掉所有
Code.exe进程;macOS 在活动监视器里结束Code Helper - 打开对应路径的
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 编码
验证是否真生效,别被假象骗了
终端、调试控制台、Git 输出、部分插件界面默认不随 locale 变,显示英文是正常现象——那是 shell 或插件自己的本地化逻辑,和 VS Code 主界面无关。
- 只盯这三处:
文件/编辑/视图顶部菜单栏、命令面板提示文字(“请输入命令或搜索设置”)、设置界面左侧导航(“用户/工作区/扩展”) - 右下角状态栏如果还显示
en,直接点击它,从下拉菜单选zh-cn是最快补救方式 - Remote-SSH / WSL 下仍英文?那是远程实例没配,得去远程机器的
~/.vscode-server/data/Machine/xxx/locale.json单独写一遍
最容易被忽略的是:命令面板输错名、插件装错、选了 zh 而非 zh-cn、点了重载窗口没点重启——只要这四件事做对,1 分钟内就能看到中文菜单。











