mac上vs code语言配置唯一有效路径是~/library/application support/code/user/locale.json,内容必须为合法json格式{"locale":"zh-cn"},且需彻底退出进程后重启才生效。

locale.json 文件路径和内容必须严格匹配
Mac 上 VS Code 读取语言配置只认一个路径:~/Library/Application Support/Code/User/locale.json。它不看 $HOME/.vscode/locale.json,也不看 /Applications/Visual Studio Code.app/Contents/Resources/app/ 下的任何文件。如果你在其他位置新建或修改了同名文件,VS Code 会静默忽略——右下角状态栏持续显示 en 就是典型信号。
文件内容只能是合法 JSON,且仅含一个字段:{"locale":"zh-cn"}。常见错误包括:
- 用了单引号:
{'locale':'zh-cn'}→ 非法 JSON - 多加了逗号:
{"locale":"zh-cn",}→ 解析失败 - 带 BOM 或换行:
{"locale":"zh-cn"}\n→ 读取失败(无提示) - 大小写/连字符错:
{"locale":"zh_CN"}、{"locale":"ZH-CN"}、{"locale":"zh-hans"}→ 全部无效
改完 locale.json 后必须彻底退出再启动
Mac 上「关掉所有窗口」≠「退出进程」。VS Code 后台常驻 Electron 和 Code Helper 进程,它们缓存着旧的 locale 设置。只要这些进程还在,哪怕你重命名了 locale.json,新启动的窗口仍可能沿用英文。
正确操作顺序是:
- 按
Cmd + Q退出 VS Code(不是只关窗口) - 打开「活动监视器」,搜索并强制退出所有含
Code或Electron的进程 - 确认 Dock 中 VS Code 图标已消失(没小圆点)
- 再双击应用图标启动,或从终端运行
code
如果重启后右下角仍是 en,大概率是进程没杀干净,或者文件被写到了错误路径。
命令面板执行 Configure Display Language 是首选,但会自动写入 locale.json
Cmd + Shift + P → 输入 Configure Display Language → 选 zh-cn → 点 Restart,这个流程本质就是自动帮你生成或覆盖 ~/Library/Application Support/Code/User/locale.json。它比手动编辑更可靠,因为绕过了编码、路径、权限等干扰项。
但要注意两个关键点:
- 命令面板里必须输全称
Configure Display Language,缩写config lang或拼错字母都搜不到 - 弹出的语言列表中要**点击
zh-cn文字本身**,不是点旁边的「简体中文」描述文字——后者只是显示名,实际值才是生效依据
如果命令执行后没反应,说明语言包没装好,或 VS Code 没加载到内置资源(新版 1.76+ 已内置,无需额外插件;老版本需确保 ms-ceintl.vscode-language-pack-zh-hans 已启用)。
部分界面仍是英文?这不是 locale.json 没生效
菜单栏、设置页、命令面板、侧边栏 hover 提示变成中文,就说明 locale.json 已正确生效。终端、调试控制台、Git 输出、Remote-SSH 插件的连接面板、GitHub Pull Requests 的 WebView 页面……这些仍显示英文,是正常现象。
它们不走 VS Code 主进程的 locale 配置,而是各自调用系统语言环境、插件自身 i18n 实现,或依赖底层工具(如 Git、Node.js)的语言设置。盯住这三处验证即可:
- 顶部菜单栏文字(文件、编辑、视图…)
- 左侧活动栏 hover 提示(“Explorer” → “资源管理器”)
- 设置里搜索
locale,查看Display Language项的当前值是否为zh-cn
其他地方英文,不是你配错了,是设计如此——别为了它反复重装插件或改 settings.json。











