VSCode 中文界面不生效，90% 是因 locale.json 路径错、内容错或未彻底重启；必须置于用户级配置目录，内容为 {"locale":"zh-cn"}，且需杀掉残留进程后全新启动。
VSCode 中文界面不生效，90% 是因为 locale.json 文件路径错、内容错、或没彻底重启——它不是“改完就生效”的配置，而是一个必须严格满足三要素的开关文件。
为什么改了 locale.json 还是英文？
VSCode 只在启动时读取一次 locale.json，且只认特定路径下的合法 JSON。常见失败点包括：
-
locale.json被放在.vscode/（工作区目录）下——该路径完全不被读取 - 文件名写成
locale.txt、Locale.json（大小写敏感）或locale.json.bak - 内容写成
{"locale": "zh_CN"}或{"locale": "Chinese"}——只接受小写连字符格式zh-cn - 用记事本或某些编辑器保存出带 BOM 的 UTF-8 编码，VSCode 会静默跳过该文件
- 后台还有
Code.exe（Windows）或Electron（macOS/Linux）进程在运行，新配置不会加载
locale.json 的正确路径和内容
必须确保文件位于用户级配置目录，且内容为单行标准 JSON：
- Windows：
%APPDATA%\Code\User\locale.json - macOS：
$HOME/Library/Application Support/Code/User/locale.json - Linux：
$HOME/.config/Code/User/locale.json
文件内容只能是这一行（无空格、无注释、无尾逗号）：
{"locale":"zh-cn"}
推荐用 VS Code 自己新建并保存该文件，天然规避 BOM 和编码问题；别用系统自带文本编辑器。
dmap-jsapi-skill
下载
DMap GL地图JSAPI（dmapgl）开发指南。用于编写、审查、调试 DMap 地图 API 代码，涵盖地图初始化、覆盖物渲染、图层管理、事件处理、控件交互等任务。当用户提及 dmap、dmapgl、jsapi‑gl 或相关地图开发需求时自动触发。
命令行快速创建 locale.json（Linux/macOS）
终端里执行以下命令最稳，前提是路径存在且权限正常：
- 先确保目录存在：
mkdir -p ~/.config/Code/User - 写入配置：
echo '{"locale":"zh-cn"}' > ~/.config/Code/User/locale.json - 杀掉所有残留进程：
pkill -f "Code Helper\|Electron" - 全新启动 VS Code（不是
code .，而是双击图标或运行code）
Windows 用户可用 PowerShell 执行：echo '{"locale":"zh-cn"}' | Out-File -FilePath "$env:APPDATA\Code\User\locale.json" -Encoding UTF8，注意必须用 UTF8（非 UTF8-BOM）。
Remote-SSH / WSL 环境下中文不生效？
这不是配置错了，是远程实例读的是远程机器上的 locale.json，和本地完全无关：
- Remote-SSH 连接后，按
Ctrl+Shift+P运行Developer: Open User Data Folder，进User/目录编辑locale.json - WSL 中需进入
~/.vscode-server/data/Machine/（路径含哈希后缀）下的User/locale.json - 语言包也得在远程端单独安装，本地插件不会同步过去
真正容易被忽略的是：终端面板、调试控制台、Git 输出、部分 WebView 插件界面默认不随 locale.json 变——那是它们自己的语言环境，不是你配错了。
