VSCode 中文界面需装官方简体中文语言包、执行 Configure Display Language 命令选 zh-cn、重启窗口,并确保用户级 locale.json 内容为 {"locale":"zh-cn"},三者缺一不可。

VSCode 界面仍是英文,不是插件没装,而是 locale 没被正确写入或读取——装对包、选对 zh-cn、重启所有进程,三者缺一不可。
安装 Microsoft 官方中文语言包
搜“中文”“汉化”大概率装错第三方包,它们不更新、翻译残缺,甚至导致 Cannot read property 'translate' of undefined 报错。必须只认准这一项:
- 在扩展面板(
Ctrl+Shift+X)搜索完整名称:Chinese (Simplified) Language Pack for Visual Studio Code - 发布者必须是
Microsoft,ID 必须是ms-ceintl.vscode-language-pack-zh-hans - 装完右下角会弹提示,但此时界面仍为英文——这是正常现象,语言包只是“字典”,还没被调用
执行 Configure Display Language 命令设 zh-cn
这个命令不是可选项,而是唯一能生成合法 locale.json 的入口。手改 settings.json 里的 "locale": "zh-cn" 在 VS Code 1.70+ 已被彻底弃用,静默忽略。
- 按
Ctrl+Shift+P(macOS 是Cmd+Shift+P)打开命令面板 - 输入
Configure Display Language并回车 - 从列表中严格选择
zh-cn(小写、短横线;zh_CN、zh-hans、Chinese全无效) - 看到提示 “需要重启窗口以应用更改”,必须点
Restart——Developer: Reload Window不会重读语言配置
检查 locale.json 是否落对位置且格式正确
右下角状态栏仍显示 en?说明 VS Code 没读到有效配置。常见硬伤不是不会操作,而是路径或格式错位:
-
locale.json必须放在用户级路径,不是工作区目录:
Windows:%APPDATA%\Code\User\locale.json
macOS:~/Library/Application Support/Code/User/locale.json
Linux:~/.config/Code/User/locale.json - 文件内容必须严格为一行:
{"locale":"zh-cn"}(无空格、无 BOM、无多余逗号或引号) - Remote-SSH / WSL 下仍英文?那是远程实例没配——要去远程机器的
~/.vscode-server/data/Machine/xxx/locale.json单独写一遍
验证是否真生效,别被假象骗了
只看三个地方:顶部菜单栏(文件/编辑/视图)、命令面板提示(“请输入命令或搜索设置”)、设置页左侧导航(“用户/工作区/扩展”)。这三处是中文,才算成功。
- 终端、调试控制台、Git 输出、部分插件右键项显示英文,属于设计限制,不是汉化失败
- 点了右下角状态栏的
en→ 选zh-cn,只改当前窗口,新窗口仍可能回退英文——必须靠全局locale.json或命令面板设置 - 如果反复失败,优先检查是否装了多个语言包冲突,或企业策略锁死了
locale写入权限
最常卡住的其实是:插件 ID 错、命令输成 Configure Language、选了 zh 而非 zh-cn、点了重载窗口没点重启。只要这四件事做对,1 分钟内就能看到中文菜单——但一旦涉及 Remote-SSH 或多用户环境,locale.json 就得在对应实例路径里各写一份,这点容易被忽略。











