如果你搜过让 JSON 变得可读的方法,大概都见过 “JSON viewer” 和 “JSON formatter” 这两类工具 —— 也好奇过它们是不是一回事。它们并不相同,只是随着工具变得更强大,边界变得模糊。理解二者的区别能帮你挑对工具:格式化原始 API 输出、调试时探索嵌套很深的响应,或在不丢失上下文的前提下浏览一个大型配置文件。
什么是 JSON 格式化器(formatter)?
JSON 格式化器接受原始、未格式化的 JSON —— 通常是一行很长的字符串 —— 用一致的缩进和换行重写它。数据本身没有变化,变的只是空白。
// 原始输入
{"user":{"id":42,"name":"Alice","roles":["admin","editor"],"active":true}}
// 格式化之后(2 空格缩进)
{
"user": {
"id": 42,
"name": "Alice",
"roles": [
"admin",
"editor"
],
"active": true
}
}
格式化器是一种文本操作。它读取 JSON 字符串、规范化空白,然后输出一个新字符串。大多数格式化器在副作用上还会校验 JSON —— 如果 JSON 不合法,格式化器无法正确缩进,会抛出错误。
JSON 格式化器擅长什么:
- 几秒内把被压缩的 API 响应变得可读
- 在团队内统一缩进风格(2 空格 vs 4 空格 vs 制表符)
- 产出可用于文档或日志的美化输出
- 作为一种快速判断 JSON 是否合法的检查
什么是 JSON 查看器(viewer)?
JSON 查看器 —— 有时也叫 JSON reader 或 JSON explorer —— 走得更远一步。它不输出格式化文本,而是把 JSON 渲染成一个你可以浏览的交互式结构。
JSON 查看器的关键特性是 可折叠节点。每个对象 {} 和数组 [] 都可以单独展开或收起。这意味着你可以先看一个 1 万行响应的顶层,找到关心的部分,只展开那一支,忽略其他所有内容。
典型的 JSON 查看器还会提供:
- 语法高亮 —— 键、字符串、数字、布尔和 null 各自有独特的颜色,结构一目了然
- 可折叠/展开的节点 —— 折叠整个子树以减少视觉噪声
- 子项数量 —— 折叠的节点显示子项数量,一目了然(例如
[...] 24 items) - 键的导航 —— 不必滚动数千行,就能找到特定的键
JSON 查看器擅长什么:
- 浏览大型、深度嵌套的 API 响应
- 在事先不了解数据形状的情况下进行调试
- 审查只关心其中几节的配置文件
- 快速理解陌生的 JSON 结构
“JSON 树形查看器” 就是同一个东西
你也会看到同样的功能被称作 JSON tree viewer、JSON tree,或 collapsible JSON tree。三个名字说的都是把文档渲染成由可展开节点构成的交互式层级。如果你想专门搜这个词,请看 JSON Tree Viewer:把 JSON 当作可折叠树来浏览。
你其实已经有一个:浏览器 DevTools
值得知道:Chrome、Firefox 和 Edge 都会在响应的 Content-Type 是 application/json 时渲染一个内置的、可折叠的 JSON 查看器。直接打开该 URL(或在 Network 面板的 Preview 中查看),你就免费获得一棵树 —— 不需要任何扩展。对快速阅读非常合适;但面对超大负载、需要 “全部折叠” 控件或键搜索时,专用查看器更胜一筹。
核心区别一句话总结
最简单的理解:格式化器改变文本的 外观;查看器改变你与数据 交互 的方式。
| JSON 格式化器 | JSON 查看器 | |
|---|---|---|
| 输出 | 格式化文本 | 交互式树 |
| 可折叠节点 | 无 | 有 |
| 语法高亮 | 有时有 | 始终有 |
| 可作为文本复制 | 可以 | 通常通过导出 |
| 最适合 | 整理输出 | 探索结构 |
什么时候用 JSON 格式化器
当你需要 可读的文本输出 时使用格式化器 —— 可以粘贴、提交、打日志或发给同事的内容。
在终端里读 API 响应
你运行 curl https://api.example.com/users/42,得到一大坨压缩 JSON。粘贴到格式化工具里,几秒就能让它变得可读。
提交前统一文件风格
如果团队的风格指南要求 2 空格缩进,格式化器可以一致地强制执行这一点,不必手工修改。
快速校验合法性
把一段疑似坏掉的 JSON 粘进格式化器,马上就能知道它能否被解析。看到报错说明 JSON 不合法;能干净地格式化就说明它合法。
文档和截图
美化后的 JSON 在文档、README 文件和 Slack 消息里看起来比一行压缩文本好得多。
什么时候用 JSON 查看器
当你需要 浏览和探索 数据时使用查看器 —— 当你尚不清楚 JSON 里到底有什么、关心的内容在哪里时。
探索大型 API 响应
你收到一份包含几十个嵌套对象和数组的响应。把顶层节点折叠起来就得到了结构的地图。只展开你正在查的那一支。
在不了解 schema 的情况下调试
第一次对接第三方 API 时,查看器让你能在写任何解析代码之前,通过点击树形结构来理解对象之间的关系。
读深度嵌套的配置
Kubernetes manifest、AWS CloudFormation 模板等文件常常嵌套多层。查看器让在五层深的地方找到某个具体设置变得切实可行。
对比不同环境下的数据形状
把生产响应和预发响应并排展开。折叠后的节点让你一眼看出哪些部分不一样。
好的 JSON 查看器都有哪些共同点
并不是所有 JSON 查看器都一样。区分好用和难用的关键如下:
- 全部折叠 / 全部展开 控件 —— 你需要能瞬间重置视图;没有 “全部折叠” 按钮的查看器只能让你一个个关节点
- 在大文件上稳定的性能 —— 一些基于浏览器的查看器在面对几万个节点时会吃力;最好的工具能稳稳地处理这种情况
- 准确的语法高亮 —— 键应当和字符串值有区分;数字、布尔和 null 在视觉上应当各自不同
- 对边角情况的稳妥处理 —— 空对象、空数组、null 值和深嵌套结构都要正确渲染
- 不需要上传数据 —— 你的 JSON 经常包含敏感数据;一切在浏览器本地处理的查看器比把数据发到服务器的安全得多
JSON Reader:它和 viewer 又有区别吗?
“JSON reader” 通常和 “JSON viewer” 互换使用 —— 它描述的是阅读和浏览 JSON 的行为,而不是编辑或重新格式化。如果你看到一个工具叫做 JSON reader,基本可以肯定它提供的是基于树的导航和可折叠节点,与 viewer 相同。
偶尔 “reader” 会出现在代码语境中 —— 比如 Java 的 Gson 库里的 JsonReader —— 但在 Web 工具的语境里,reader 和 viewer 是一回事。
你两个都需要吗?
需要 —— 而且大多数好工具会同时具备这两种能力。现代 JSON 工具会先把输入格式化(统一缩进)并且 把它渲染成可浏览的树。格式化文本和交互式查看器共存:你可以根据当下任务选用哪种视图。
区别最重要的时刻,是工具只为其中之一而设计时。命令行格式化器如 jq 或 python -m json.tool 只给你文本输出。浏览器扩展中的专用查看器只给你树形导航。日常工作里,一个浏览器内同时具备两种能力的工具是最实用的选择。
如何选对工具
如果你主要在终端工作
jq 是事实标准。它用一种强大的表达式语言对 JSON 进行格式化、过滤和查询。它没有查看器,但在脚本化工作流中无可匹敌。
如果你在代码编辑器中工作
装了 Prettier 扩展的 VS Code 能在保存时格式化 JSON。对于树形浏览,大多数浏览器 DevTools 自带的 JSON 编辑器其实出乎意料地好用。
如果你需要一个快速、即贴即看的方案
基于浏览器的工具是最快的途径。挑一个边打字边校验、提供可折叠树视图、能稳稳处理大文件、并把数据保留在本地的工具。fixjson 的 JSON 查看器 全部做到 —— 粘贴你的 JSON,树立刻渲染出来,不会把数据发往任何服务器。
如果你面对的是损坏或不合法的 JSON
标准的格式化器或查看器都帮不上忙 —— 你需要先用 JSON 修复工具。修复工具能处理常见错误,如 尾随逗号、单引号、以及 未加引号的键,然后再把清理过的 JSON 交给查看器或格式化器。
常见问题
JSON 查看器和 JSON 格式化器有什么区别?
格式化器输出可读、带缩进的 文本,你可以复制;查看器渲染一个交互式 树,带可折叠节点和语法高亮,可供浏览。格式化器 = 文本看起来怎样;查看器 = 你如何与数据交互。
JSON 查看器和 JSON reader 是一回事吗?
在 Web 工具里,是的 —— “reader”、“viewer” 和 “explorer” 都描述的是带可折叠节点的树形导航。(像 Gson 这类代码库里的 “JsonReader” 与之无关。)
我需要同时有查看器和格式化器吗?
大多数现代工具已经把两者合在一起 —— 它们格式化输入并在同一视图里渲染一棵可折叠树,所以你永远不必在可读性和可浏览性之间二选一。
如果 JSON 是坏的怎么办?
查看器和格式化器都帮不上忙 —— 先用 JSON Fix 修复,然后再查看或格式化清理后的输出。也请参见 如何格式化 JSON。
结语
JSON 格式化器给你可读的文本。JSON 查看器给你一棵交互式树。两者都有用 —— 用哪一个,取决于你需要的是可以复制粘贴的输出,还是能点击浏览的结构。
对大多数开发者来说,理想的工具是两者兼具:它会先格式化输入,并在同一视图里渲染一棵可折叠的树。这样你永远不必在可读性和可浏览性之间做选择。
如果你的 JSON 在尝试查看之前就已经损坏,先把它修好 —— 查看器和格式化器都需要合法的 JSON 作为输入;修复工具不需要。
来源
- jq 手册 — 命令行 JSON 格式化器与查询工具
- Prettier — 保存时格式化 JSON（及代码）
- Firefox JSON 查看器 — 浏览器内置的可折叠 JSON 查看器
最后审阅:2026 年 6 月。