JSON 差异对比

比较两个 JSON 对象并可视化差异,输出 RFC 6902 JSON Patch 操作和彩色树形差异视图,在浏览器中运行。

  • 在浏览器中处理
  • 工具不会把输入上传到 ZeroTool 服务器
  • 免费 · 无需注册
点击「比较」或按 Ctrl+Enter(Mac 为 ⌘+Enter)。两侧都必须是合法 JSON。只在请求时比较;格式和对象键顺序不影响 Patch。 「清除」清空两侧输入、结果与状态。焦点在工具内时,Ctrl+L(Mac 为 ⌘+L)执行相同操作。 「交换」交换两侧输入并清除结果。再次点击「比较」生成反向 Patch。
输入原始 JSON 值:对象、数组、字符串、数字、布尔值或 null。JSON 不接受注释和尾随逗号。数字采用 JavaScript 精度。
输入修改后的 JSON 值。数组按下标比较,不按 id 字段配对。编辑任一输入会清除旧结果,不会自动比较。
结果 有差异时,「收起输入」保留文本并腾出结果空间;「展开输入」恢复编辑框。两个值相同时,只显示状态提示,不生成 Patch。

比较两个 JSON 值后,这里显示 Patch 与可视差异。

示例、说明与常见问题 带实际输出的示例、与同类工具的差别,以及常见问题。

使用场景

  • 审查不同版本之间的 API 响应变更。
  • 为 PATCH HTTP 接口生成 Patch 操作。
  • 审计配置文件变更。
  • 调试应用中意外的数据变更。

相关工具:JSON 格式化 — 在差异对比前格式化并验证 JSON。

示例:一次 API 响应的变化

原 JSON:

{"name":"Alice","status":"pending","legacy_id":12345,"tags":["a","b","c"],"profile":{"age":30,"city":"Paris"}}

新 JSON(键顺序变了,status 改了,删除 legacy_id,新增 role,去掉第一个标签):

{"status":"active","name":"Alice","role":"admin","tags":["b","c"],"profile":{"age":31,"city":"Paris"}}

JSON Patch:

[
  { "op": "replace", "path": "/status", "value": "active" },
  { "op": "remove", "path": "/legacy_id" },
  { "op": "replace", "path": "/tags/0", "value": "b" },
  { "op": "replace", "path": "/tags/1", "value": "c" },
  { "op": "remove", "path": "/tags/2" },
  { "op": "replace", "path": "/profile/age", "value": 31 },
  { "op": "add", "path": "/role", "value": "admin" }
]

键顺序不影响结果:name 换了位置但不会被报告。这个 Patch 用 Python 的 jsonpatch 1.33 应用后得到「新 JSON」。

示例:雪花 ID 订单为什么显示“未发现差异”

不少 Java 后端用雪花算法生成 19 位的 Long 型主键,例如 MyBatis-Plus 的 IdType.ASSIGN_ID 默认用雪花算法生成 ID(MyBatis-Plus 注解文档)。接口如果把它当数字输出,比较两条订单时:

[
  { "op": "replace", "path": "/status", "value": "已支付" }
]
检测到 1 处变更。JavaScript 无法精确保存以下数字,按舍入后的值比较,因此其中的差异可能漏报,Patch 也写入舍入后的值:原 JSON /orderId: 1830000000000000001 → 1830000000000000000; 新 JSON /orderId: 1830000000000000002 → 1830000000000000000。

两个订单号在 JavaScript 里都变成 1830000000000000000,所以 Patch 只有 status 一条,订单号的变化被漏掉了;状态栏把两处舍入都列了出来。RFC 8259 指出,只有 [-(2^53)+1, (2^53)-1] 范围内的整数在各实现之间能保证一致(RFC 8259 第 6 节)。这类 ID 最好在接口里以字符串输出。

示例:收货地址与商品列表

键名是中文时,Patch 路径里直接写中文;按下标比较的数组,删掉第一件商品后会显示成「替换 + 删除」:

[
  { "op": "replace", "path": "/收货地址/市", "value": "广州市" },
  { "op": "replace", "path": "/商品/0/sku", "value": "B2" },
  { "op": "replace", "path": "/商品/0/数量", "value": 1 },
  { "op": "remove", "path": "/商品/1" }
]

A1 那一行其实是被删除了,但工具不按 sku 配对,而是把第 0 项改成 B2 的内容,再删掉第 1 项。应用这个 Patch 后的结果与「新 JSON」相同,只是读起来不像“删除一件商品”。

数组如何比较

数组按下标比较,而不是按内容。同一个数组删除多个元素时,删除按下标从大到小写出。例如一张订单原有 3 个商品行、现在只剩 1 个且数量变了:

[
  { "op": "replace", "path": "/items/0/qty", "value": 3 },
  { "op": "remove", "path": "/items/2" },
  { "op": "remove", "path": "/items/1" }
]

执行 remove /items/2 后数组还剩两项,/items/1 仍然存在。若按从小到大的顺序,第二条删除会越过数组末尾;任一操作失败,整个 Patch 即失败(RFC 6902 第 5 节)。超出较短数组长度的元素写成 remove(大下标在前)或 add(小下标在前)。

路径与 JSON Pointer 转义

Patch 里的路径是 JSON Pointer(RFC 6901):~ 写成 ~0,/ 写成 ~1。{"a/b":1,"m~n":2,"list":[1,2,3]} → {"a/b":2,"list":[1,2,3,4],"x":null} 的结果:

[
  { "op": "replace", "path": "/a~1b", "value": 2 },
  { "op": "remove", "path": "/m~0n" },
  { "op": "add", "path": "/list/3", "value": 4 },
  { "op": "add", "path": "/x", "value": null }
]

两边根节点类型不同(如对象与数组)时,Patch 替换整个文档,路径是空串 ""(RFC 6901 中 / 指向名为空字符串的成员)。可视差异用点号连接键名(profile.age、list.3),只是方便阅读。

限制

  • 不生成 move、copy 操作;改名的键显示为 remove 加 add。
  • 对象数组不会按 id 或 sku 字段配对。
  • 两边都必须是合法 JSON,状态栏会指出哪一边解析失败,例如 原 JSON 解析错误:Expected double-quoted property name in JSON at position 7(原因部分是浏览器给出的英文)。
  • 数字按 JavaScript 解析后比较:1.0 与 1 相同,-0 在 Patch 里写成 0。超过 2^53 且无法用 double 精确表示的整数(如 9007199254740993;9007199254740994、1e20 能精确表示)和很长的小数会被舍入,1e400 这类超出 double 范围的数会变成 Infinity。状态栏列出它们(最多 10 个,其余写出个数),Patch 写入读到的值(1e400 写成 null)。
  • 同一对象中重复出现的键只保留最后一个值,状态栏会列出。
  • 嵌套约 1,900 层(Node.js 22 中测得,浏览器之间有差异)的文档无法比较,状态栏会给出提示。
  • 工具的测试把每个生成的 Patch 用严格的 RFC 6902 实现(以及已安装时的 Python jsonpatch)应用到「原 JSON」,结果必须等于「新 JSON」,另跑 3,000 组随机文档。

FAQ

什么是 RFC 6902 JSON Patch?

RFC 6902 定义了一种 JSON 文档格式,用于表达对 JSON 文档的一系列操作。每个操作是一个包含 'op'(add/remove/replace/move/copy/test)、'path'(RFC 6901 JSON Pointer)和可选 'value' 的对象。本工具只生成 add、remove、replace 三种操作。

可视差异是如何工作的?

工具逐层递归比较。只在「新 JSON」中存在的键显示为新增(+),只在「原 JSON」中存在的键显示为删除(−),值发生变化的键显示为修改(~),同时列出旧值和新值。可视差异里的路径用点号连接,只方便阅读;代码里请使用 Patch 中的 JSON Pointer 路径。

两个订单号明明不同,为什么显示“未发现差异”?

JavaScript 把 JSON 数字读成 64 位浮点数,超过 2^53 且无法用 double 精确表示的整数和很长的小数会被舍入,1830000000000000001 和 1830000000000000002 都变成 1830000000000000000。工具按读到的值比较,但会扫描两侧原文,把被舍入的数字和同一对象中重复出现的键连同 JSON Pointer 路径写进状态栏(各列出前 10 个,其余写出个数)。

可以比较大型 JSON 吗?

没有大小上限,只在点击「比较」时在当前标签页中计算。实际的限制是嵌套层数:嵌套约 1,900 层的文档(在 Node.js 22 中测得,浏览器之间有差异)会耗尽调用栈,状态栏会提示没有完成比较。

这与文本对比工具有什么不同?

文本对比工具逐行比较纯文本。JSON 差异工具理解 JSON 结构,对值进行语义比较而非文本比较,并输出机器可读的 JSON Patch 操作。

我的 JSON 数据会被发送到服务器吗?

不会。两份 JSON 在当前浏览器标签页中比较,不会发送出去,也不会保存到浏览器存储。比较一组新的输入并发现差异时,页面统计会记录一次使用事件(只含工具名和动作 diff),不包含 JSON 或 Patch 内容。