必须彻底退出vs code并执行developer: reload window才能使locale.json生效；该文件须严格置于用户级路径（如windows的%appdata%\code\user\locale.json），内容仅限{"locale":"zh-cn"}，且需安装官方中文语言包。
必须彻底退出 VS Code 并点击 Reload Window，否则 locale.json 写对了也白写。
locale.json 文件必须放在用户级路径下
VS Code 只读取特定位置的 locale.json，放错地方就完全不生效：
- Windows：
%APPDATA%\Code\User\locale.json - macOS：
~/Library/Application Support/Code/User/locale.json - Linux：
~/.config/Code/User/locale.json
别把它塞进 .vscode/ 工作区目录、locales/ 子目录，或用记事本另存为带 BOM 的 UTF-8——VS Code 会静默忽略。用 VS Code 自己新建并保存该文件，能天然避开编码问题。
内容格式有硬性要求，错一个字符都不行
locale.json 不是 settings.json，它只认一个字段，且大小写、符号、空格全敏感：
- 必须是
{"locale":"zh-cn"}（小写zh-cn，不能是zh_CN、zh-CN、zh或Chinese） - 必须用英文双引号，不能用中文引号或单引号
- 不能有多余逗号、空格、注释或换行（JSON 格式要严格合法）
- 文件名必须是
locale.json，不是locale.txt或Locale.json
Reload Window 是唯一生效触发点
改完 locale.json 后，仅保存文件没用，必须让 VS Code 重新加载语言上下文：
dmap-jsapi-skill
下载
DMap GL地图JSAPI（dmapgl）开发指南。用于编写、审查、调试 DMap 地图 API 代码，涵盖地图初始化、覆盖物渲染、图层管理、事件处理、控件交互等任务。当用户提及 dmap、dmapgl、jsapi‑gl 或相关地图开发需求时自动触发。
- 确保所有 VS Code 进程已退出（检查 Windows 任务管理器里的
Code.exe，macOS 活动监视器里的Electron） - 启动 VS Code，打开任意窗口，按
Ctrl+Shift+P输入Developer: Reload Window并执行 - 千万别只按
Ctrl+R刷新页面，或关掉再重开——只有Reload Window会重建 UI 语言栈
远程环境（如 WSL / Remote-SSH）要单独操作：在远程窗口里执行 Developer: Reload Window，本地 reload 不影响远程实例。
中文语言包未安装会导致配置静默失效
locale.json 设了 "zh-cn"，但界面仍是英文？大概率是缺语言包：
- 打开扩展面板（
Ctrl+Shift+X），搜Chinese (Simplified) Language Pack for Visual Studio Code - 确认发布者是
Microsoft，点击 Install - 装完后必须再执行一次
Developer: Reload Window，否则语言包不会激活
Remote-SSH 和 WSL 还得在对应远程机器上单独装这个插件——本地装了，远程照样英文。
最容易被忽略的一点：VS Code 的语言设置不继承终端环境。如果你从 shell 启动（比如 code .），而终端的 $LANG 是 en_US.UTF-8，它可能覆盖 locale.json。建议直接从桌面图标启动，或在终端中先执行 unset LANG LC_ALL 再运行 code。
