JSON 差异对比
比较两个 JSON 对象并可视化差异,输出 RFC 6902 JSON Patch 操作和彩色树形差异视图,在浏览器中运行。
- 在浏览器中处理
- 工具不会把输入上传到 ZeroTool 服务器
- 免费 · 无需注册
用微信扫描以下二维码即可分享
示例、说明与常见问题 带实际输出的示例、与同类工具的差别,以及常见问题。
使用场景
- 审查不同版本之间的 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 内容。