VSCode中文界面必须通过用户级locale.json文件配置，路径为Windows:%APPDATA%\Code\User\locale.json、macOS:~/Library/Application Support/Code/User/locale.json、Linux:~/.config/Code/User/locale.json；内容须为严格JSON格式{"locale":"zh-cn"}（小写、连字符、无空格、无BOM、UTF-8编码），且需彻底退出进程后重启才生效。
locale.json 文件必须放在用户级配置目录，不能放错路径
VSCode 只读取特定位置的 locale.json，其他任何地方写的都无效。它不认 settings.json 里的 "locale" 字段，也不读项目根目录或 .vscode 下的同名文件。
- Windows：
%APPDATA%\Code\User\locale.json - macOS：
~/Library/Application Support/Code/User/locale.json - Linux：
~/.config/Code/User/locale.json
常见错误是手动生成时路径写成 ~/.vscode/locale.json 或 ~/.config/Code/locale.json（缺 User 子目录），结果 VSCode 完全无视。用命令面板执行 Configure Display Language 是最保险的生成方式——它自动确保路径和文件名完全正确。
内容必须是合法 JSON，且值严格匹配 BCP 47 标准
locale.json 不是随便写个字符串就行，格式错一个字符就失效。它只接受标准 JSON，且 locale 值必须小写、连字符、无空格：
- ✅ 正确：
{"locale":"zh-cn"}、{"locale":"en"}、{"locale":"ja"} - ❌ 错误：
{"locale":"zh_CN"}、{"locale":"zh-hans"}、{"locale": "zh-cn"}（键值前后有空格）、{"locale":"zh-cn",}（尾逗号）
文件编码也必须是 UTF-8 无 BOM。用记事本或 Sublime Text 直接保存容易带 BOM，推荐用 VSCode 自己新建并保存，或用终端命令：echo '{"locale":"zh-cn"}' > ~/.config/Code/User/locale.json。
DMap GL地图JSAPI（dmapgl）开发指南。用于编写、审查、调试 DMap 地图 API 代码，涵盖地图初始化、覆盖物渲染、图层管理、事件处理、控件交互等任务。当用户提及 dmap、dmapgl、jsapi‑gl 或相关地图开发需求时自动触发。
改完必须彻底退出 VSCode，否则新配置不加载
VSCode 启动时只读一次 locale.json，运行中不会重新加载。只点「Reload Window」或关掉所有窗口还不够——后台进程（如 Code Helper、Electron）还在，就会继续用旧缓存。
- Windows：打开任务管理器，结束所有
Code.exe和Code Helper.exe - macOS/Linux：终端执行
pkill -f "Code Helper\|Electron" - macOS 还要检查菜单栏右上角是否还有 VSCode 小图标，有就得右键退出
远程场景（Remote-SSH / WSL）更要单独处理：本地改了没用，得在远程机器对应路径下也建一份 locale.json，再在远程窗口里执行 Developer: Reload Window。
别装第三方“汉化插件”，官方语言包已内置
VSCode 1.76+ 版本起，简体中文、繁体中文、日文等主流语言包已直接打包进主程序，无需额外安装扩展。装了非官方的“中文补丁”“一键汉化”类插件，反而容易导致：
- 启动变慢、命令面板乱码、设置页部分区域仍是英文
- 与系统区域设置冲突，比如 macOS 上同时启用了
PreferredUILanguages组策略 - 升级后语言回退，甚至破坏
locale.json解析逻辑
唯一需要确认的是：命令面板里搜 Configure Display Language 能否看到 zh-cn 选项。能看到，说明内置包就绪；看不到，才需去扩展市场安装官方 Chinese (Simplified) Language Pack for Visual Studio Code（发布者 Microsoft，ID ms-ceintl.vscode-language-pack-zh-hans）。
