真正起作用的只有 Microsoft 官方简体中文语言包(ID:ms-ceintl.vscode-language-pack-zh-hans),安装后必须通过 Configure Display Language 命令设置 zh-cn 并重启窗口,手动编辑 locale.json 文件可确保生效,验证以菜单栏、命令面板和设置导航为准。

必须装 Microsoft 官方 Chinese (Simplified) Language Pack for Visual Studio Code
第三方“汉化插件”如 Chinese Menu、VSCode Chinese Pro 只改菜单栏几个字,命令面板、报错提示、设置项全是英文,还可能触发 Cannot read property 'translate' of undefined 报错。真正起作用的只有一个: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)打开扩展面板 - 搜索完整名称,别信“中文”“汉化”等关键词,更别点缩写或带括号变体
- 认准蓝勾图标 + “Microsoft”署名,点击
Install - 安装后右下角弹出提示,必须点
Restart Now—— 点Reload Window不生效
Configure Display Language 命令只接受 zh-cn,大小写和连字符都不能错
插件只是放好了翻译资源,真正激活中文靠的是 Configure Display Language 命令。它不认 zh_CN、ZH-CN、Chinese、zh-hans,也不报错,只会静默维持英文界面。
正确操作:
- 按
Ctrl+Shift+P打开命令面板(不是Ctrl+P) - 输入
Configure Display Language,从下拉列表中**明确点击值为zh-cn的那一项**(不是显示为“简体中文”的文字项) - 弹窗提示“是否重启窗口”,必须点
Yes——Reload Window无效 - 该命令本质是写入
locale.json,如果命令搜不到或选完没反应,大概率是插件没装成功,或 VS Code 没读到配置路径
命令失效时直接编辑 locale.json 文件最稳
命令面板卡死、输不了字、或选了 zh-cn 重启后仍是英文,说明 VS Code 没成功写入配置。此时手动改文件比反复重试更可靠,但 90% 的“改了没反应”都源于改错路径或没关干净进程。
关键步骤:
- 彻底退出 VS Code:Windows 查任务管理器杀光所有
Code.exe;macOS 在活动监视器结束Code Helper或Electron进程 - 编辑对应路径下的
locale.json(不是settings.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"}(无 BOM、无多余空格、无逗号、JSON 合法) - 保存后全新启动,右下角状态栏会显示当前语言代码(如
zh-cn),点击它也能快速切换
验证是否真生效,别被 Git 面板或插件界面误导
终端、调试控制台、Git 输出、部分插件 WebView 页面默认不随 locale 变——那是它们各自的语言环境,不是 VS Code 汉化失败。真正反映汉化是否成功的只有三处:
- 顶部菜单栏(文件 / 编辑 / 视图)
- 命令面板提示(“请输入命令或搜索设置”)
- 设置界面左侧导航(用户 / 工作区 / 扩展)
这三处对了,就是真汉化成功。其他地方仍是英文,优先查插件自身配置(如 gitlens.language)、主题是否覆盖、或 Remote-SSH/WSL 是否在远程端也配了语言包。











