JSON Diff 对比

什么是 JSON Diff？

// Two JSON documents that look different but are semantically equal
const a = '{"a":1,"b":2}';
const b = '{"b":2,"a":1}';

// Naive comparison — wrong
JSON.stringify(JSON.parse(a)) === JSON.stringify(JSON.parse(b));
// → false (key order differs)

// JSON Diff (this tool) — correct: key order is irrelevant
// → 0 differences

// JSON Patch (RFC 6902) for { "a": 1 } → { "a": 2 }
// [{ "op": "replace", "path": "/a", "value": 2 }]

核心特性

示例

{"user":{"id":1,"name":"Ada","createdAt":"2024-01-01"}}

{"user":{"id":1,"name":"Ada Lovelace","createdAt":"2024-02-02"}}

{"a":1,"b":2,"c":3}

{"c":3,"a":1,"b":2}

[{"id":1,"qty":3},{"id":2,"qty":5}]

[{"id":2,"qty":5},{"id":1,"qty":4}]

{"items":[{"id":1,"price":29.99}]}

{"items":[{"id":1,"price":24.99}]}

使用方法

1. 1

   粘贴两份 JSON

   把原始（左）和修改后（右）JSON 粘贴进来。边输入边渲染 live diff；大输入（>200 KB）会切换到手动 Diff 按钮。

2. 2

   过滤噪音

   点预设（Timestamps / IDs / Trace）或粘贴 Extended JSON Pointer 模式到 Ignore paths，去掉无关字段。

3. 3

   选择需要的视图

   Side-by-Side 适合人眼 review，JSON Patch (RFC 6902) 适合机器自动应用。点 Share Link 把配置发给同事。

常见 Diff 陷阱

diff a.json b.json   # text diff: 'everything changed'

JSON Diff (this tool): 0 differences

{"a": null} == {}   # collapsed by some tools

{"a": null} ≠ {}     # type-strict diff

Sequential diff: 4 modified

Match by key (id): 0 differences

{"id": 42} vs {"id": "42"}   # serialization bug

Diff reports 'modified (type)' with both values

tolerance=0:  0.30000000000000004 ≠ 0.3

tolerance=1e-9: equal

Diff: 47 modifications (45 are timestamps)

Add /createdAt, /updatedAt, /requestId to Ignore paths → 2 real changes

常见使用场景

API 响应回归

对比 staging 与 production 的响应；忽略 timestamps 和 request IDs，只暴露真正有意义的 payload 变化。

CI Snapshot 测试失败

把失败的 Jest/Vitest snapshot 的 actual vs expected 粘进来。秒级过滤噪音找出真实变化。

package-lock / yarn.lock 冲突

按 name 对齐依赖来解决合并冲突；键序和无关字段不再是噪音。

K8s / Helm Values 审计

按 name 对齐 envs、volumeMounts、ports。识别误改顺序与真实配置变更。

i18n 翻译完整性检查

对 en.json 与 zh.json 做结构 diff，找出缺失或多余的翻译 key，避开值噪音。

Terraform / CDK Plan 复核

对比多次 plan 输出；numeric tolerance 处理浮点运算，ignore paths 抹掉 ARN 和 timestamps。

技术细节

RFC 6902 兼容的 Patch 输出

生成合法的 JSON Patch ops（add/remove/replace），路径符合 RFC 6901。已与 fast-json-patch@3.x 和 rfc6902 npm 包交叉校验。

迭代式遍历

显式栈遍历（不递归），上限 100,000 节点 + 深度 64，防止恶意输入触发栈溢出。

Object.is 数值相等

默认 numeric tolerance 为 0 —— 用 Object.is，所以 -0 与 +0 严格区分。设置 tolerance > 0 进入 epsilon 比较。

最佳实践

先过滤再 review

先加 Ignore paths（timestamps、IDs、trace 字段），再读 diff。看噪音满屏的 diff 会让眼睛习惯性跳过 —— 然后错过真正的变化。

逻辑集合用 Match by key

如果你的数组表示无序集合（envs、users、依赖项），就用 Match by key。对逻辑集合做 Sequential diff 几乎肯定是错的。

Share Link 不要 share 输入

用 Share Link 把过滤配置发给同事 —— 永远不要把敏感 JSON 粘到共享文档。URL 里只有配置。

常见问题