vs code 的 locale.json 必须严格按平台路径存放:windows 在 %appdata%\code\user\,macos 在 $home/library/application support/code/user/,linux 在 $home/.config/code/user/;内容仅允许一行 {"locale":"zh-cn"},无空格、无注释、无 bom;修改后需彻底退出所有 vs code 进程再重启;远程开发(ssh/wsl)需在远程 ~/.vscode-server/data/machine/ 下单独配置。

locale.json 文件路径必须精准匹配系统平台
VS Code 只在特定路径下读取 locale.json,写错目录等于白配。它不认工作区路径、不认 settings.json 所在目录,也不读系统级或全局配置。
- Windows:
%APPDATA%\Code\User\locale.json(等价于C:\Users\<strong>用户名</strong>\AppData\Roaming\Code\User\locale.json) - macOS:
$HOME/Library/Application Support/Code/User/locale.json - Linux:
$HOME/.config/Code/User/locale.json
注意:%APPDATA% 和 $HOME 是环境变量,别手动替换成字面路径再拼错;用资源管理器/访达/文件管理器直接粘贴路径时,确保已展开变量(比如 macOS 上用 Cmd+Shift+G 输入完整路径)。
JSON 内容只允许一行且格式零容忍
locale.json 不是普通配置文件,VS Code 对它的解析极其严格:多一个空格、少一个引号、带 BOM、加注释、写成 locale.js,整份配置都会被静默忽略。
- 唯一合法内容就是这一行:
{"locale":"zh-cn"} - 键名
locale必须双引号包裹 - 值
zh-cn必须小写、短横线分隔、无空格、无下划线(zh_CN、zh-hans、Chinese全无效) - 不能有逗号结尾,不能有换行,不能有 UTF-8 BOM(用 VS Code 自己新建并保存最稳)
改完必须彻底退出 VS Code 进程
VS Code 启动时只读一次 locale.json。如果后台还有残留进程,新配置永远不会加载——哪怕你点了「重启窗口」也无效。
DMap GL地图JSAPI(dmapgl)开发指南。用于编写、审查、调试 DMap 地图 API 代码,涵盖地图初始化、覆盖物渲染、图层管理、事件处理、控件交互等任务。当用户提及 dmap、dmapgl、jsapi‑gl 或相关地图开发需求时自动触发。
- Windows:打开任务管理器 → 结束所有
Code.exe进程(包括「后台进程」标签页里的) - macOS:活动监视器 → 搜索
Electron或Code→ 强制退出全部相关进程 - Linux:终端执行
pkill -f "code"或killall code
托盘图标还在?说明没关干净。重开前务必确认进程已清空。
远程开发(SSH/WSL)要单独配 locale.json
本地设好了中文,远程窗口还是英文?因为 Remote-SSH 和 WSL 运行的是独立的 VS Code Server,它读的是远程机器上的 locale.json,和本地完全无关。
- 在 WSL 或远程服务器终端中,进入:
~/.vscode-server/data/Machine/(后面可能带哈希后缀目录) - 在该目录下新建
locale.json,内容仍是:{"locale":"zh-cn"} - 保存后,在远程窗口中执行
Developer: Reload Window(不是本地窗口)
容易被忽略的是:远程 locale.json 路径和本地不同,且没有自动创建机制——必须手动写,否则永远英文。










