vscode界面汉化失败的根源是未安装microsoft官方中文语言包、未正确配置locale为"zh-cn"或未彻底重启;必须安装id为ms-ceintl.vscode-language-pack-zh-hans的插件,通过configure display language命令选择严格小写的zh-cn并重启,或手动编辑对应路径下的locale.json为{"locale":"zh-cn"}。

VSCode 界面汉化失败,99% 是因为没装对插件、没设对 zh-cn、或者没彻底重启——三者缺一不可。装完第三方“中文菜单”插件后命令面板还是英文?那是假汉化,直接卸掉。
怎么找对唯一有效的中文语言包
搜“中文”“汉化”“Chinese Pro”大概率装错。真正起作用的只有一个: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)打开扩展面板 - 搜索框里**完整粘贴**:
Chinese (Simplified) Language Pack for Visual Studio Code(注意括号、空格、大小写) - 只点蓝白 VS 图标 + 蓝勾认证 + Microsoft 署名的那个,点击 Install
- 安装完右下角弹出 Restart Now 提示——必须点它;点
Reload Window不生效
Configure Display Language 命令为什么总选不对 zh-cn
这个命令本质就是写入 locale.json,但它对值极其敏感:只认 zh-cn(全小写、短横线),zh_CN、ZH-CN、zh-hans、Chinese 全无效,且不报错,静默失败。
- 按
Ctrl+Shift+P打开命令面板(不是Ctrl+P) - 输入
Configure Display Language,从下拉列表中**明确点击**zh-cn项(不是“简体中文”文字,那是显示名) - 弹窗提示“是否重启窗口”,必须点 Restart;点 No 或关掉弹窗,配置根本不会写入
- 如果命令面板空白、输不了字、或列表里没有
zh-cn,说明插件没加载成功,直接跳到手动改文件步骤
locale.json 手动编辑路径和格式必须严格
命令失效时,手动编辑 locale.json 是最稳解法,但 90% 的“改了没反应”都源于路径错、格式错、或进程没杀干净。
- 先彻底退出 VS Code:
– Windows:任务管理器中杀光所有Code.exe
– macOS:活动监视器中结束Code Helper和Electron进程
– Linux:pkill -f "code" - 用文本编辑器打开对应路径的
locale.json:
– Windows:%APPDATA%\Code\User\locale.json
– macOS:$HOME/Library/Application Support/Code/User/locale.json
– Linux:$HOME/.config/Code/User/locale.json - 文件内容必须严格为一行合法 JSON:
{"locale":"zh-cn"}
– 无 BOM
– 无多余空格或逗号
– 不是settings.json,往settings.json里加"locale": "zh-cn"完全无效
最容易被忽略的是:终端、调试控制台、Git 输出、部分插件界面默认不随 locale 变——那是它们各自的语言环境,不是 VS Code 汉化失败。盯住顶部菜单栏、左侧活动栏 hover 文字、设置里搜 locale 看值是否为 zh-cn,这三处对了,就是真汉化成功。











