mac版vs code汉化必须将locale.json严格置于~/library/application support/code/user/locale.json,内容为{"locale":"zh-cn"}(单行、utf-8、无bom、无注释、无多余字段),改后需cmd+q彻底退出并重启验证。

Mac上locale.json路径和文件名必须严格匹配
Mac版VS Code读取语言配置只认~/Library/Application Support/Code/User/locale.json这个路径,其他位置如~/.vscode/locale.json或~/Library/Application Support/Code/locale.json(缺User)均无效。如果多个同名文件共存,VS Code可能随机读错一个,导致汉化失效。
常见翻车点:
-
~/.vscode/locale.json被旧插件或手动操作残留,优先删掉它 - 用
code --user-data-dir启动过 VS Code,会绕过默认路径,改了也白改 - 路径里用了中文用户名或空格,但 VS Code 能正常处理,无需转义
locale.json内容必须是合法JSON且仅含locale字段
文件内容只能是单行、无BOM、UTF-8编码的严格JSON:{"locale":"zh-cn"}。多一个空格、少一个引号、加个逗号、写成zh_CN或zh-hans,VS Code都会静默忽略整个文件,界面维持英文,且不报错。
不能出现这些写法:
-
{"locale": "zh-cn",}(末尾逗号非法) -
{"locale": 'zh-cn'}(单引号不合法) -
// 这是注释 {"locale":"zh-cn"}(JSON不支持注释) -
{"locale":"zh-cn","foo":"bar"}(只允许locale字段)
改完必须彻底退出再启动,不能靠Reload Window
Reload Window只刷新编辑器状态,不重载语言资源。必须用Cmd + Q退出所有窗口,再确认活动监视器中没有Electron或Code Helper进程残留,最后双击图标重新启动。
DMap GL地图JSAPI(dmapgl)开发指南。用于编写、审查、调试 DMap 地图 API 代码,涵盖地图初始化、覆盖物渲染、图层管理、事件处理、控件交互等任务。当用户提及 dmap、dmapgl、jsapi‑gl 或相关地图开发需求时自动触发。
验证是否生效的关键动作:
- 右下角状态栏点击语言代码,应显示
zh-cn - 命令面板(
Cmd + Shift + P)顶部提示语变成「请输入命令或搜索设置」 - 设置界面(
Cmd + ,)左侧导航栏显示「用户」「工作区」「扩展」
终端、Git、调试控制台仍是英文不是配置失败
这些区域不走 VS Code 的locale.json机制:终端依赖系统 Shell 语言环境,Git 提示由 Git 自身决定,调试控制台使用 Node.js 或运行时本地化逻辑。它们显示英文是设计如此,不是汉化没成功。
真正要盯住的只有三处:
- 顶部菜单栏(文件 / 编辑 / 视图)
- 左侧活动栏 hover 文字(如“探索”“搜索”“源代码管理”)
- 命令面板占位符和设置页面左侧导航
这三处全中文,就说明locale.json已正确加载。其他地方英文不用折腾,也改不了。










