vscode 中文界面需同时安装 microsoft 官方简体中文语言包(id:ms-ceintl.vscode-language-pack-zh-hans)并执行 configure display language 命令选择 zh-cn;手动编辑 locale.json 文件内容为 {"locale":"zh-cn"} 可解决命令失效问题。

VSCode 设置中文界面只有两条路走通:装对插件 + 用对命令,缺一不可;其他任何“搜中文就点安装”“改 settings.json”“手动复制语言文件”的操作,99%会失败或半残。
必须安装 Microsoft 官方中文语言包
第三方插件(比如叫“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呼出命令面板,输入Configure Display Language(注意大小写和空格) - 从下拉列表中**明确点击**
zh-cn,不是“简体中文”文字项(那个是显示名,实际值才是关键) - 弹窗提示“是否重启窗口”,必须点
Yes,否则locale.json不生成或不更新
命令面板失效时直接改 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,这三处对了,就是真汉化成功。











