VSCode 中文界面唯一可靠方法是安装 Microsoft 官方简体中文语言包(ms-ceintl.vscode-language-pack-zh-hans)、设置 locale 为 zh-cn 并彻底重启;其他插件或配置均无效或导致异常。

VSCode 中文界面只有一条可靠路径:装对插件 + 选对 locale 值 + 彻底重启,三者缺一不可;其他任何“搜中文就点安装”“改 settings.json”“手动复制语言文件”的操作,基本都会失败或半残。
必须安装 Microsoft 官方 Chinese (Simplified) Language Pack
第三方插件(比如叫“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打开扩展面板,搜索完整名称(小写,别信“汉化”“中文菜单”等关键词) - 认准蓝勾图标 + “Microsoft”署名,点击 Install
- 安装完右下角弹出 Restart Now 提示——必须点它,只“重载窗口”不生效
Configure Display Language 命令只认 zh-cn
插件只是放好了翻译资源,真正激活中文靠的是 Configure Display Language 命令。它不接受任何变体:zh_CN、ZH-CN、Chinese、zh-cn(首字母大写)全无效,且不报错,只会静默维持英文。
- 按
Ctrl+Shift+P呼出命令面板(不是Ctrl+P),输入Configure Display Language - 从下拉列表中明确点击
zh-cn(不是“简体中文”文字项,那是显示名) - 弹窗提示“是否重启窗口”,必须点 是——
Developer: Reload Window不会重读语言配置
命令失效时直接编辑 locale.json
如果命令面板卡死、输不了字、或选了 zh-cn 重启后仍是英文,说明 VS Code 没成功写入配置。此时绕过 UI,手动编辑 locale.json 是最稳解法。
- 彻底退出 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"}(无 BOM、无多余空格、无逗号、JSON 格式合法)
真正容易被忽略的是:终端、调试控制台、Git 输出、部分插件界面默认不随 locale 变——那是它们各自的语言环境,不是 VS Code 汉化失败。盯住顶部菜单栏、左侧活动栏 hover 文字、设置里搜 locale 看值是否为 zh-cn,这三处对了,就是真汉化成功。


















