必须执行Configure Display Language命令生成正确路径的locale.json并彻底重启，手动编辑易出错；沙盒安装（snap/flatpak）会屏蔽该文件，需改用官网安装包；同时须启用微软官方中文语言包ms-ceintl.vscode-language-pack-zh-hans。
locale.json 配置后界面仍乱码，基本不是文件写错了，而是 VS Code 根本没读到它，或读到了但被其他机制覆盖了。
locale.json 路径和内容必须严格合规
VS Code 只认用户级 ~/.vscode/locale.json（macOS/Linux）或 %USERPROFILE%\AppData\Roaming\Code\User\locale.json（Windows），不读 settings.json 里的 "locale" 字段（1.70+ 已废弃）。文件内容必须是合法 JSON，且仅含一个字段：
-
{"locale":"zh-cn"}—— 小写、无空格、无注释、无多余字段（比如别加"fallback"或"_comment"） - 如果手写时用了中文引号、多了逗号、或者保存成了 UTF-8 with BOM，VS Code 会静默忽略整个文件
- 用 VS Code 自己执行
Configure Display Language命令生成的文件最可靠；手动编辑后务必用 JSON 验证器校验
沙盒安装（snap/flatpak）会直接屏蔽 locale.json
如果你的 which code 返回路径含 /snap/bin/code 或 /var/lib/flatpak，那无论 locale.json 多干净、语言包多完整，中文界面都会显示为方块——这是沙盒权限限制，不是配置问题。
DMap GL地图JSAPI（dmapgl）开发指南。用于编写、审查、调试 DMap 地图 API 代码，涵盖地图初始化、覆盖物渲染、图层管理、事件处理、控件交互等任务。当用户提及 dmap、dmapgl、jsapi‑gl 或相关地图开发需求时自动触发。
- 运行
sudo snap remove code卸载 snap 版，改用官网 .deb 或 .rpm 包安装 - flatpak 用户可尝试
flatpak override --filesystem=host com.visualstudio.code，但有安全风险，不推荐长期使用 - 验证是否生效：终端执行
code --status，看输出里user data dir是否指向你预期的路径
语言包没启用，locale.json 就是空转
locale.json 只是告诉 VS Code “我想用 zh-cn”，但它不会自动加载对应语言资源——必须装且启用微软官方语言包 ms-ceintl.vscode-language-pack-zh-hans。
- 打开扩展面板（
Ctrl+Shift+X），搜Chinese (Simplified) Language Pack，只保留发布者为ms-ceintl的那一项 - 禁用所有其他中文语言包（尤其名称相似但发布者是第三方的），它们会互相注册冲突，导致 locale 加载失败
- 安装后必须完全退出 VS Code：
killall code（Linux/macOS）或任务管理器结束所有Code进程，再重启
界面部分乱码（比如设置页某行是方块）大概率是字体问题
菜单栏中文正常、但某个开关 label 是方块，这不是 locale.json 或语言包的问题，而是系统 fallback 到了不支持 Unicode 的等宽字体。
- 检查
editor.fontFamily和terminal.integrated.fontFamily设置，确保值里包含明确支持中文的等宽字体，例如"Fira Code", "Sarasa Mono SC", "JetBrains Mono" - Windows 用户若用了
"Consolas"，它不支持中文，必须显式追加中文字体名，如"Consolas, Microsoft YaHei" - Linux 用户需确认系统已安装 Noto Sans CJK 或 wqy-microhei 等开源中文字体
真正容易被忽略的是：VS Code 启动时对 locale.json 的读取是一次性且静默的——它不报错、不提示、不 fallback，读失败就直接用英文界面。所以每次改完，必须彻底杀进程再启，不能只是重载窗口。
