最稳路径是用 command + shift + p 执行 configure display language 并选 zh-cn 后重启,因其唯一能自动定位、写入并校验 locale.json;其他方式易因大小写、引号、逗号或注释等 json 语法错误导致失败。

Mac 上 VSCode 切中文,最稳路径只有一条:用 Command + Shift + P 调出命令面板,输入并执行 Configure Display Language,选 zh-cn,点 Restart —— 其他所有“点设置改选项”“拖文件进目录”“改 Settings.json”的做法,90% 会卡在重启后仍是英文。
为什么 Command + Shift + P 是唯一可靠入口
VSCode 的界面语言不走 Settings UI,也不读系统语言,它只认 locale.json 文件里的 "locale" 字段。而 Configure Display Language 命令是唯一能自动定位、打开、写入并校验这个文件的官方机制。
- 拼错命令(比如
config display language或大小写错误)→ 搜不到,白按 - 用鼠标点菜单栏“VSCode > 首选项 > 设置”,再搜“language”→ 找到的是
editor.language或locale.explorerResourceLabelFormat,这些和界面语言完全无关 - 终端里执行
code --user-data-dir=/tmp/test启动过 → 它会绕过默认locale.json,改了也无效
locale.json 内容必须严格合法
执行 Configure Display Language 后,VSCode 会自动打开 ~/Library/Application Support/Code/User/locale.json。你只需确认内容是且仅是:
{"locale":"zh-cn"}
常见非法写法直接导致启动失败或回退英文:
-
"locale": "ZH-CN"(大小写敏感,必须小写zh-cn) -
"locale": 'zh-cn'(JSON 只认双引号,单引号报错) -
{"locale":"zh-cn",}(末尾多逗号,JSON 语法非法) - 文件里混了注释,比如
// 这是中文(JSON 不支持任何注释) - 同时存在
$HOME/.vscode/locale.json→ 它优先级更高,建议直接删掉
Chinese (Simplified) 插件现在是“开关”,不是“可选项”
VSCode 1.76+ 已把简体中文资源内置进二进制,但插件 Chinese (Simplified) Language Pack for Visual Studio Code 仍必须启用——它负责激活右键菜单、调试面板、问题面板等 WebView 区域的翻译逻辑。
- 没装?去扩展面板(
Command + Shift + X)搜Chinese (Simplified),点安装 - 已装但灰色显示“禁用”?点启用;若显示“Install”,说明上次被误卸载了
- 装了多个中文包(如社区版
vscode-language-pack-zh-hans)?卸载非微软官方的,只留一个 - 插件启用后仍不生效?不是插件问题,是
locale.json没写对,或没彻底退出重开
重启必须“彻底”,不能只是关窗口
Mac 上 VSCode 进程常驻后台,关掉所有编辑器窗口 ≠ 进程退出。残留进程会继续读旧的 locale.json 缓存。
- 正确操作:按
Command + Q,或点击菜单栏VSCode > Quit Visual Studio Code - 验证是否退出干净:打开活动监视器,搜
Code,确认无Code Helper (Renderer)或Code主进程残留 - 别用 Dock 图标右键“重新打开”——它可能复用旧进程;应双击 Applications 文件夹里的
Visual Studio Code.app - 重启后某处还是英文(比如 Remote-SSH 插件页)?那是插件自身没做中文适配,不是你配置错了
真正容易被忽略的点是:升级 VSCode 后,插件可能自动停用,或者某次“恢复默认设置”清掉了 locale.json。下次突然满屏英文,别慌,Command + Shift + P → Configure Display Language → zh-cn → Restart,三步拉回正轨。











