Sublime中JSON格式化失败主因是未安装Package Control；需先安装并重启，再用HTML-CSS-JS Prettify插件，配置JSON支持、UTF-8编码、关闭detect_indentation且设indent_size为2。
Sublime 里 JSON 格式化失败，大概率是没装 Package Control
所有 JSON 格式化插件都依赖 Package Control，它不是可选项，是硬性前提。按 Ctrl+Shift+P（Windows/Linux）或 Cmd+Shift+P（macOS）调不出命令面板，或者输入 Install Package 没反应，基本等于没装。别跳过这步——去官网复制 Python 安装脚本，粘贴进 View → Show Console 执行，然后必须重启 Sublime Text。重启后右下角状态栏才可能显示 JSON 语法选项，插件命令才真正可用。
别用 JsFormat 或 Pretty JSON：它们会悄悄破坏数据
JsFormat 把 JSON 当 JS 解析，会偷偷改结构：比如把 {"a": null} 变成 {"a": "null"}，把反斜杠 "path\file" 转义成 "path\\file"，甚至删掉你临时加的注释（哪怕只是开发时写的 // test）。Pretty JSON 在 Sublime Text 4 上常报 ImportError: No module named 'pathlib' 或 No module named 'sublime'，因为它依赖旧版 Python 环境，而 ST4 默认用 Python 3.8+。
- 推荐用
HTML-CSS-JS Prettify：基于js-beautify，能自动修复尾随逗号、补双引号、转单引号为双引号 - 安装后必须手动开启 JSON 支持：打开
Preferences → Package Settings → HTML-CSS-JS Prettify → Settings，确认"json": true已启用 - 它不默认绑定快捷键，需在
Preferences → Key Bindings（右侧用户文件）加这条：
[{"keys": ["ctrl+alt+j"], "command": "html_css_js_prettify", "args": {"type": "json"}, "context": [{"key": "selector", "operator": "equal", "operand": "source.json"}]}]
格式化前必须检查三件事，否则静默失败
很多“点不动”“没反应”的问题，其实根本没报错，只是条件不满足：
DMap GL地图JSAPI（dmapgl）开发指南。用于编写、审查、调试 DMap 地图 API 代码，涵盖地图初始化、覆盖物渲染、图层管理、事件处理、控件交互等任务。当用户提及 dmap、dmapgl、jsapi‑gl 或相关地图开发需求时自动触发。
- 右下角语言模式必须是
JSON（不是Plain Text或JavaScript）：点击右下角语言名，手动选JSON或JSON with Comments - 内容必须是合法 JSON：不能有单引号、尾随逗号、
undefined、NaN、注释。验证方法：终端运行python -m json.tool yourfile.json，或浏览器控制台执行JSON.parse(你的字符串) - 编码必须是
UTF-8（不是UTF-8 with BOM）：BOM 会导致js-beautify静默失败。右下角看编码标识，如果不是UTF-8，用File → Reopen with Encoding → UTF-8重载
缩进忽大忽小？关掉 detect_indentation 就行
HTML-CSS-JS Prettify 默认会尝试检测当前文件缩进风格，结果经常和你设置冲突，导致格式化后缩进混乱（比如有的行 2 空格，有的 4 空格）。解决方法很直接：
- 在插件设置中显式关闭：
"detect_indentation": false - 同时设
"indent_size": 2（符合 JSON RFC 推荐值） - 确保全局缩进统一为空格：执行
View → Indentation → Convert Indentation to Spaces，再设Indent Using Spaces - 别在用户配置（
Preferences → Settings）里写"detect_indentation": true，它会覆盖插件设置
真正麻烦的不是装插件，而是每份 JSON 文件背后藏着的编码、语法、缩进三重校验。漏掉任意一项，快捷键就变成摆设。
