Sublime如何配置JSON格式化工具?(美化压缩切换)

3次阅读

推荐优先使用sublime text 4内置的indent xml/json功能,专为json设计、无需配置、无编码问题;次选轻量插件json reindent;避免jsbeautify等将json误作js处理导致格式错误。

Sublime如何配置JSON格式化工具?(美化压缩切换)

JSON格式化插件选哪个?别装 JSBeautify

Sublime 默认不带 JSON 格式化能力,装错插件会踩坑:比如 JSBeautify 对纯 JSON 文件支持差,缩进错乱、中文乱码、甚至把 {"a":1} 错误转成 {"a": 1,}(多加逗号导致解析失败)。真正靠谱的是 JSON Reindent 或原生 Indent XML/JSONsublime 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 直接触发
  • 避免 JSBeautifyHTML-CSS-JS Prettify:它们把 JSON 当 JS 对象处理,容易破坏原始结构

怎么一键切换「美化」和「压缩」?用 Build System 最稳

Sublime 没有内置“压缩 JSON”功能,但可以用 Build System 调用系统命令快速实现,比插件更可控、不卡顿、不改文件编码。

关键点:压缩本质是移除空白和换行,不是“反向格式化”,所以不能靠缩进命令倒推。必须走外部工具链。

  • 先确认系统有 python(3.6+)或 jq:运行 python -m json.tool --helpjq --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,删掉冲突项(常见于 EmmetSideBarEnhancements
  • 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 验证 + 手动控编码,是最少意外的路。

text=ZqhQzanResources