VSCode中文界面生效需严格满足三条件：①locale.json必须置于用户数据目录对应路径（Windows/macOS/Linux各一）；②文件内容仅允许{"locale":"zh-cn"}（UTF-8无BOM、小写、连字符、无空格）；③修改后须彻底终止所有VS Code进程并重启。
locale.json 文件路径必须严格匹配用户数据目录
VS Code 只读取特定路径下的 locale.json，写错位置等于没写。它不认工作区目录（.vscode/locale.json）、不认系统级路径、也不认带空格或中文的父目录。
正确路径只有三处，且大小写敏感、不能拼错：
- Windows：
%APPDATA%\Code\User\locale.json - macOS：
$HOME/Library/Application Support/Code/User/locale.json - Linux：
$HOME/.config/Code/User/locale.json
常见错误：把文件建在 ~/.vscode/ 或 /usr/share/code/ 下；或者误写成 local.json、locale.txt、Locale.json——这些全被忽略，无提示。
JSON 内容必须合法且极简
locale.json 不是 settings.json，它只接受一个字段，且格式容错率为零。任何多余字符都会导致 VS Code 静默回退到英文界面。
必须满足全部以下条件：
- 全文仅一行：
{"locale":"zh-cn"}（注意双引号、小写、连字符） - 不能有注释、不能有尾逗号、不能换行、不能有空格（包括开头/结尾）
- 不能用全角引号、不能用单引号、不能写成
zh_CN或ZH-CN - 编码必须是 UTF-8 无 BOM —— 用 VS Code 自己新建并保存该文件最保险
别依赖编辑器自动补全大括号或引号，手动敲一遍更稳。如果已有文件，删光所有内容，只粘贴这一行再保存。
DMap GL地图JSAPI（dmapgl）开发指南。用于编写、审查、调试 DMap 地图 API 代码，涵盖地图初始化、覆盖物渲染、图层管理、事件处理、控件交互等任务。当用户提及 dmap、dmapgl、jsapi‑gl 或相关地图开发需求时自动触发。
改完必须彻底退出再重启
VS Code 后台进程（如 Code Helper、Electron）会缓存语言配置。只点「重新加载窗口」或关掉所有窗口，旧进程仍在运行，新 locale.json 就不会被读取。
操作前务必确认进程已清空：
- Windows：打开任务管理器 → 结束所有
Code.exe进程 - macOS：活动监视器 → 搜索并结束
Code Helper和Electron - Linux：终端执行
pkill -f "Code Helper\|Electron"
之后再双击图标启动，才是全新加载。右下角状态栏显示 zh-cn 才算真正生效。
Remote-SSH / WSL 环境要单独配
你在本地配好了 locale.json，连上 Remote-SSH 或 WSL 后仍是英文，不是失败，而是远程端跑的是另一个 VS Code Server 实例，它读自己的配置。
必须分别处理：
- Remote-SSH 连接后，按
Ctrl+Shift+P→ 运行Developer: Open User Data Folder→ 进入User/目录新建或编辑locale.json - WSL 中先执行
code --list-extensions确认 server 已启，再进~/.vscode-server/data/Machine/xxx/User/locale.json（路径含哈希后缀） - 远程端的语言包也得单独安装，同步设置不会自动装插件
最容易被忽略的是：你改了本地配置，却忘了远程端还挂着旧 locale —— 它们完全独立，没有继承关系。
