操作教程

如何在线格式化 JSON

来自 API 响应或配置文件的原始 JSON 常常被压缩成长长的一行。在那种状态下阅读、调试或编辑它都很痛苦。本指南会教你如何三次点击就把 JSON 美化成带正确缩进的样子、校验其语法错误，并在需要时再把它压缩回去，而这一切都在你的浏览器中运行，数据不会离开你的标签页。

分步操作

打开 JSON 格式化工具，把你的 JSON 粘贴到左侧面板。你可以直接从剪贴板（Ctrl+V）、从命令行的 curl 响应，或从任意文本编辑器中粘贴。只要在工具的上限之内，输入接受任意大小。
选择模式。格式化会添加缩进（2 或 4 个空格，由你决定）；校验只检查语法而不修改 JSON；压缩会去掉所有空白字符以产生尽可能小的输出。对于大多数用例，你想要的就是格式化。
点击“运行”。格式化后的输出会出现在右侧面板。用“复制”按钮把它复制下来，再粘贴回你的编辑器或配置文件。工具会显示行数和字符数，让你一眼就能核对输出的大小。

看懂错误信息

当你的 JSON 存在语法错误时，格式化工具会连同一个位置（行号和列号）一起显示错误，指向那个破坏解析的确切字符。常见的元凶有：数组或对象最后一项之后多了一个逗号（在 JavaScript 中合法，在 JSON 中不合法）、缺失或多余的闭合括号、未用双引号包裹的键，或字符串内部未转义的特殊字符。修正被标出的位置后再次运行。

JSON、YAML 与 CSV：分别该用哪个

JSON 是 API 响应和需要被代码读取的配置文件的标准。YAML 更适合由人手动编辑的配置（标点更少，支持注释）。CSV 最适合供电子表格使用的表格数据。本站的数据转换器让你一步在这三种格式之间互转：粘贴 JSON，点击转换，输出 YAML 或 CSV。当你需要把数据塞进 URL 查询参数或带大小限制的 HTTP 头时，压缩后的 JSON 也很有用。

本指南用到的工具

常见问题

我的 JSON 会被发送到任何服务器吗？

不会。格式化工具完全在你的浏览器中运行。你的 JSON 由浏览器原生的 JSON.parse 解析，输出在内存中构建：没有任何内容经过网络传输。当 JSON 包含 API 密钥、令牌、内部数据或个人信息时这一点尤为重要，而这在 API 调试流程中很常见。

我最多能粘贴多大的内容？

格式化工具接受最大 5 MB 的 JSON。超过这个大小，在主线程上解析会让浏览器标签页卡死且没有任何反馈。对于更大的 JSON 文件，请使用专门的桌面工具，比如命令行上的 jq（jq . file.json），它能毫无问题地处理几百兆字节。