Mac版VSCode汉化失败主因是未通过Command+Shift+P执行Configure Display Language并选zh-cn后重启,且需确保Chinese (Simplified)插件已启用、locale.json内容为{"locale":"zh-cn"}并彻底退出重开。

Mac版VSCode汉化失败,90%是因为没走对命令面板入口,或插件没真正启用——不是系统语言影响,也不是设置里改个选项就能生效。
Command + Shift + P 是唯一可靠入口
Mac 上改 VSCode 界面语言,必须用 Command + Shift + P(不是 Ctrl,别手滑),输 Configure Display Language ——注意拼写,少一个字母或大小写错(比如 configure display language)都搜不到。这个命令直接触发 locale 配置流程,比在设置里翻“语言”“区域”“locale”等关键词快且稳。
选中后会弹出语言列表:en-us 和 zh-cn 是默认可见项。点 zh-cn,VSCode 会自动下载语言资源并提示重启。不点 Restart 按钮,改了也白搭。
Chinese (Simplified) 插件必须已安装且启用
VSCode 自 1.80 版起,zh-cn 依赖插件 Chinese (Simplified) Language Pack for Visual Studio Code(微软官方发布)。它不只是翻译菜单,还负责右键菜单、错误提示、内置文档的中文渲染。
- 点左侧扩展图标(方块拼图),搜
Chinese (Simplified) - 确认状态是“已启用”,不是灰色“Install”或“禁用”
- 如果只有“Install”,点它;装完仍不生效,再执行一次
Configure Display Language→zh-cn→Restart - 新版 VSCode(1.76+)已内置简体中文支持,但插件仍需启用——卸载它反而会导致部分界面回退英文
locale.json 文件不能手动乱改
路径是 ~/Library/Application Support/Code/User/locale.json,内容必须严格为:{"locale":"zh-cn"}。常见翻车点:
- 写成
"locale": "ZH-CN"(大小写敏感) - 用了单引号:
'zh-cn'(JSON 只认双引号) - 多加逗号:
{"locale":"zh-cn",}(非法 JSON) - 混入注释:
// 这是错的(JSON 不支持注释) - 文件存在但被其他路径覆盖:比如
$HOME/.vscode/locale.json也存在,优先级混乱,建议删掉它
改完必须彻底退出 VSCode(Cmd + Q 或关掉所有窗口),再重新启动。热重载或只关窗口不退出进程,locale 不会刷新。
重启后还是英文?先看这三个地方
不是配置没生效,而是环境干扰:
- 终端里用
code --user-data-dir启动过 VSCode?它会绕过默认locale.json,改了也无效 - 装了多个中文相关插件(比如社区版
vscode-language-pack-zh-hans),和官方插件冲突,建议只留微软那个 - 某些插件(如
Remote-SSH、GitHub Pull Requests)的 UI 是 WebView 实现,本身没做中文适配——这不是你配错了,是插件问题
最保险的兜底动作:删掉 ~/Library/Application Support/Code/User/locale.json,再用 Command + Shift + P → Configure Display Language → zh-cn,让 VSCode 自己生成合法文件。


















