VS Code 中文配置需手动创建 locale.json 文件并严格遵循路径、格式与重启流程。Linux/macOS 路径为 ~/.config/Code/User/locale.json，Windows 为 %APPDATA%\Code\User\locale.json，内容必须为 {"locale":"zh-cn"}，且需彻底杀进程后双击图标或运行 code（无参数）启动；Remote-SSH/WSL 需在远程端对应 Machine/User 目录下单独配置 locale.json 并安装中文语言包。
用 code --locale=zh-cn 启动是临时方案，不是配置生效路径
命令行直接加 --locale=zh-cn 参数能立刻让当前窗口显示中文，但它不修改任何配置文件，也不影响后续启动行为。适合快速验证、帮同事截图、或调试某个插件 UI 是否支持中文。一旦关掉这个窗口，下次双击图标打开还是英文。
常见误操作是把它当成长期设置：比如写进 shell alias 或桌面快捷方式。这会导致终端子进程（如集成终端里跑的 node、python）语言环境混乱，部分插件弹窗仍为英文——因为 --locale 只作用于主进程 UI 层，不透传到底层。
locale.json 文件必须手动生成，且路径/格式零容错
VS Code 1.70+ 版本起，locale 配置已从 settings.json 移出，只认独立的 locale.json。它默认不存在，也不能靠命令面板“触发生成”来保证路径正确——尤其在 Remote-SSH / WSL 下，命令面板运行的是远程实例，生成的文件在远程路径，本地无效。
- Windows 路径：
%APPDATA%\Code\User\locale.json - macOS 路径：
~/Library/Application Support/Code/User/locale.json - Linux 路径：
~/.config/Code/User/locale.json
内容必须严格为：{"locale":"zh-cn"}。多一个空格、少一个引号、用大写 ZH-CN、带 BOM 编码、文件名拼成 local.json，都会导致静默失效。
命令行写入 locale.json 的三步闭环操作
手动创建比依赖编辑器更可控，尤其当你发现命令面板打不开、或反复重载无效时。关键不是“写进去”，而是“写对 + 杀干净 + 重读取”：
DMap GL地图JSAPI（dmapgl）开发指南。用于编写、审查、调试 DMap 地图 API 代码，涵盖地图初始化、覆盖物渲染、图层管理、事件处理、控件交互等任务。当用户提及 dmap、dmapgl、jsapi‑gl 或相关地图开发需求时自动触发。
- 先确保目录存在：
mkdir -p ~/.config/Code/User（Linux/macOS）或md %APPDATA%\Code\User（Windows CMD） - 用 echo 直接写入（避免编辑器自动加 BOM）：
echo '{"locale":"zh-cn"}' > ~/.config/Code/User/locale.json - 彻底杀掉所有 VS Code 进程：
pkill -f "Code Helper\|Electron"（macOS/Linux），或taskkill /f /im Code.exe（Windows）
别用 code . 重开——它可能复用旧进程。双击图标或终端输入 code（无参数）才走标准初始化流程。
Remote-SSH 和 WSL 必须单独配 locale.json，本地配置完全不继承
你在本地改好了 locale.json，连上 Remote-SSH 后界面还是英文？这不是 bug，是设计如此。Remote-SSH 启动的是远程机器上的 VS Code Server，它读取的是远程端的 ~/.vscode-server/data/Machine/*/User/locale.json（路径含哈希后缀），和本地 ~/.config/Code/User/locale.json 完全无关。
实操要点：
- 连上远程后，在远程终端执行：
code --list-extensions确认 Server 已就绪 - 找到 Machine 子目录（通常形如
~/.vscode-server/data/Machine/abc123...），进入其下的User/目录 - 新建
locale.json，内容仍是：{"locale":"zh-cn"} - 在远程窗口中执行
Developer: Reload Window，不是 reload 本地窗口
最容易被忽略的是：远程端的中文语言包也要单独安装——命令面板里搜 Chinese (Simplified) Language Pack，点安装，它会落到 ~/.vscode-server/extensions/ 下。没有这个包，locale.json 就是空开关。
