推荐优先使用Sublime Text 4内置的Indent XML/JSON功能，专为JSON设计、无需配置、无编码问题；次选轻量插件JSON Reindent；避免JSBeautify等将JSON误作JS处理导致格式错误。
JSON格式化插件选哪个？别装 JSBeautify
Sublime 默认不带 JSON 格式化能力，装错插件会踩坑：比如 JSBeautify 对纯 JSON 文件支持差，缩进错乱、中文乱码、甚至把 {"a":1} 错误转成 {"a": 1,}（多加逗号导致解析失败）。真正靠谱的是 JSON Reindent 或原生 Indent XML/JSON（Sublime Text 4 内置）。
推荐优先用 Sublime Text 4 自带功能——它专为 JSON 设计，不依赖 Node.js，无编码问题，也不需要额外配置 Python 环境。
-
JSON Reindent：轻量、只做缩进，适合老旧版本；安装后右键菜单 →Reindent JSON - Sublime Text 4 内置：
Indent XML/JSON命令已默认启用，支持Ctrl+Shift+P→ 输入Indent XML/JSON直接触发 - 避免
JSBeautify、HTML-CSS-JS Prettify：它们把 JSON 当 JS 对象处理，容易破坏原始结构
怎么一键切换「美化」和「压缩」？用 Build System 最稳
Sublime 没有内置“压缩 JSON”功能，但可以用 Build System 调用系统命令快速实现，比插件更可控、不卡顿、不改文件编码。
关键点：压缩本质是移除空白和换行，不是“反向格式化”，所以不能靠缩进命令倒推。必须走外部工具链。
- 先确认系统有
python（3.6+）或jq：运行python -m json.tool --help或jq --version验证 - 新建 Build System：
Tools → Build System → New Build System，粘贴以下内容：
{
"cmd": ["python", "-m", "json.tool", "$file"],
"selector": "source.json",
"file_regex": "^(...*?):([0-9]*):?([0-9]*)",
"variants": [
{
"name": "Minify",
"cmd": ["python", "-c", "import json,sys; print(json.dumps(json.load(sys.stdin), separators=(',', ':')))", "<", "$file"]
}
]
}
保存为 JSON.sublime-build，然后用 Ctrl+B 美化，Ctrl+Shift+B → 选 Minify 压缩。
- 不用
jq是因为 Windows 默认没装，且需额外 PATH 配置；python -m json.tool全平台自带 -
Minify变体里用stdin读取，避免路径空格或中文导致命令失败 - 如果 JSON 有语法错误，
python -m json.tool会直接报错，比如Expecting property name enclosed in double quotes，这是好事——帮你提前发现非法 JSON
为什么 Ctrl+Alt+J 不起作用？检查 syntax 和 key binding 冲突
很多人配完插件发现快捷键无效，根本原因不是插件没装好，而是当前文件 syntax 没识别成 JSON，或者快捷键被其他插件劫持。
- 先看右下角状态栏：是否显示
JSON？如果不是，右键 →Set Syntax → JSON；否则Ctrl+Alt+J这类快捷键根本不会触发 - 检查 key binding 是否被覆盖：打开
Preferences → Key Bindings，搜索ctrl+alt+j，删掉冲突项（常见于Emmet或SideBarEnhancements） - Sublime Text 4 中，
Indent XML/JSON默认没有快捷键，需手动绑定：在用户 key bindings 里加：
[
{ "keys": ["ctrl+alt+j"], "command": "indent_xml_json", "args": {"type": "json"} }
]
注意 "type": "json" 必须写，否则对 .json 文件可能误用 XML 规则。
中文字段乱码、BOM 头崩溃？统一用 UTF-8 without BOM
JSON 文件含中文时，格式化后变问号或报 UnicodeDecodeError，90% 是编码惹的祸。Sublime 默认用系统编码读文件，而 JSON 标准只认 UTF-8（且不含 BOM）。
- 保存文件前务必点右下角编码名 → 选
UTF-8（不是UTF-8 with BOM） - 如果已有 BOM 文件，用
File → Reopen with Encoding → UTF-8强制重载，再保存 -
python -m json.tool在 Windows 下遇到非 UTF-8 编码会直接 crash，错误信息类似UnicodeDecodeError: 'gbk' codec can't decode byte 0x80—— 此时只能先转编码，不能硬来 - 不要依赖插件自动转码：比如某些 JSON 插件会静默把 GBK 转 UTF-8，但字段值里的中文可能被双转，结果更乱
JSON 的边界很窄：只认双引号、不认单引号、拒绝尾随逗号、要求字符串必须 UTF-8。越想让它“智能”，越容易出事。老实用 python -m json.tool 验证 + 手动控编码，是最少意外的路。
