后端同事甩给你一段 minify 过的 JSON——整 5000 字符挤在一行，字段嵌套 7 层，key 顺序还乱得一塌糊涂。你要怎么快速看懂？在线 format JSON 工具就是干这个的。这篇给你一套 4 步操作流程，并讲清 Piick JSON 格式化工具 里 Sort keys 和 Tolerant mode 这两个进阶开关怎么用。

为什么需要格式化 JSON

压缩 JSON 是为了传输体积小，但到了调试环节就是噩梦：

  • 嵌套对象超过 3 层，肉眼根本看不清谁属于谁
  • 找一个字段要在屏幕上扫几十个 },{
  • 复制粘贴到 IM 工具，引号还会被某些客户端自动转义

格式化的核心目的：让人脑能读。缩进、对齐、换行，让层级一目了然。代价是体积变大 30% 左右，但这是给开发者看的，不是给网络传的。

在线 vs 命令行工具的取舍

python -m json.tool、jq .、prettier 这些 CLI 工具也能格式化，但有 3 个问题：

  1. 需要安装和配置——新机器或同事电脑上不一定有
  2. 参数记忆负担——jq 的过滤语法、prettier --write 容易忘
  3. 隐私顾虑——粘贴到不知名的在线工具，数据可能上传

浏览器工具免安装、免登录，纯本地处理就更安心。Piick JSON 格式化工具 是 100% 客户端 JS，断开网络也能用，粘上去的内容永远不离开你的电脑。

用 Piick 格式化 JSON 的 4 个步骤

  1. 打开 Piick JSON 格式化工具，默认就是格式化模式
  2. 把压缩 JSON 粘到左侧输入框
  3. 顶部选 indent——2 空格（默认）、4 空格、Tab、最小化四种
  4. 点「格式化」按钮，右侧立刻出现美化结果，底部统计区显示 keys / arrays / maxDepth / 字节数

整段流程 30 秒内完成，不需要刷新页面，改 indent 也是即时生效。

进阶：Sort keys 和 Tolerant mode 实战

Sort keys：勾选后所有对象的 key 按字母序递归排列。两个用途：

  • Diff 友好：同一份数据不同来源，字段顺序不同会 diff 出大量假阳性，先 sort 一遍只剩真正差异
  • 统一规范：团队约定 key 顺序后，排序 JSON 的 diff 干净

注意数组内的对象不会被打乱顺序——数组是有序的，排序会破坏语义。

Tolerant mode：处理「不那么严格」的 JSON（带注释、尾逗号、单引号的草稿）。勾选后工具会自动剥掉 // 注释和 /* */ 块注释、把单引号转双引号、删掉多余的尾逗号，再按标准 JSON 格式化。这一项对前端 mock 数据和配置文件特别救命。

实操建议：先勾上 Sort keys 跑一遍，保存为标准 JSON 文件，放进版本控制。tolerant mode 留作临时处理草稿用。

现在就打开 Piick JSON 格式化工具，粘一行压扁的 JSON 进去，30 秒看到结果。