JSON 对比工具

粘贴两份 JSON,看清楚哪里改了。 不用先设置:换个比法会更清楚时,页面会提示你。

三个步骤

  1. 左边粘贴原始的 JSON。
  2. 右边粘贴修改后的 JSON。
  3. 差异会自动显示在这里。

怎么使用

  1. 粘贴两份数据

    左边放原始版本,右边放修改后的版本。可以粘贴、直接输入,或把 .json 文件拖到任一边。 没有“对比”按钮:边输入,结果边更新。

  2. 看差异列表

    每一行是一个差异:发生了什么(新增、删除、修改),以及在哪里。 点一下那一行,就会跳到“左右并排”里对应的位置。

  3. 跟着提示走

    如果项目只是换了位置,或是时间字段造成一堆干扰,会出现蓝色提示,建议更合适的比法。点一下就应用,再点一下就取消。

看懂对比结果

第一次用也没关系。下面说明页面上每个词的意思。

什么是 JSON 对比?

JSON 是程序之间传递数据常用的格式,长得像 {"name":"Ann","age":30}。对比就是找出两份数据哪里不一样,例如 API 改版前后的响应,或两个环境的配置文件。

这个工具比的是“数据”,不是“文本”。空白、换行、字段的先后顺序不同,都不算差异。

路径怎么读?

每个差异前面都有一串像 $.users[0].email 的文字,它是那个值的“地址”:

  • $ 代表整份数据
  • .users 代表名叫 users 的字段
  • [0] 代表列表里的第 1 个项目(从 0 开始数)
  • .email 代表那个项目里的 email 字段

合起来就是“users 列表第 1 个项目的 email”。

新增、删除、修改
  • 新增(绿色):右边有,左边没有。
  • 删除(红色):左边有,右边没有。
  • 修改(黄色):两边都有,但值不一样,会显示“旧值 → 新值”。
移动

列表里的项目换了位置,但还是同一条。只有在列表“按字段”对比时才会出现。

类型改变

值的种类变了,例如数字 1 变成加了引号的文本 "1"。两个看起来很像,但程序会当成不同的东西,常常是出错的原因,所以特别标出来。

每个值旁边会标出它的类型,用的是 JSON 和大多数编程语言通用的英文名称:

  • string:字符串,加引号的文本,例如 "hello"
  • number:数字,例如 42 或 3.14
  • boolean:布尔值,只有 true 或 false
  • null:没有值
  • object:对象,大括号包起来的一组字段,例如 {"a":1}
  • array:数组,中括号包起来的列表,例如 [1,2,3]
蓝色的提示是什么?

当“换个比法,很多差异就能解释”时会出现:列表只是顺序换了、数字只是写法不同(1 和 1.0),或某个字段每次都会变(时间、编号)。

点提示上的按钮就会应用,页面下方会出现“撤销”可以马上取消。结果上方会出现一个小标签说明目前用了什么,点标签上的 × 也能取消。不理提示也没关系:默认是最严格的比法,不会漏掉任何差异。

很多行看起来一样?

同一个字段在很多项目都变了(例如 100 个商品的价格),会收成一行,看起来像叠在一起的卡片,并先列出一个例子。点右边的“展开 N 条”才看每一条。

输入框变红了?

表示那一边还不是正确的 JSON。下方会说明第几行、哪里有问题。改好之后才会开始对比,这样你接着拿去用的数据一定是正确的。

小技巧
  • 输入框的行号会上色,标出差异在你粘贴的内容的哪一行:红色是删除、绿色是新增、黄色是修改。
  • JSON 挤在一行很难读?点那一边上方的“格式化”就会整理好,对比结果不会变。
  • 在列表点路径,就会跳到左右并排的那一行;在左右并排里按 J、K 可以跳到下一个、上一个差异。
  • 数据很大时要等一下,页面会显示“对比中…”,表示正在处理,你可以继续输入。
  • 选项会记在这个浏览器,下次打开还在(不会记你粘贴的内容)。结果上方的标签会一直显示目前用了哪些选项。

常见问题

我的 JSON 会被上传吗?

不会。 两份文档都在你的浏览器里对比,页面不会把你粘贴的内容发送到任何服务器。

  • 没有“在线保存”或分享链接,你的数据不会意外出现在公开网址上。
  • 你粘贴的内容不会被保存,连浏览器里也不会;只有对比选项(例如要忽略的字段)会记在你的浏览器里。
  • 页面加载后即使断网,也能继续使用。
键的顺序或空白会算作差异吗?

不会。{"a":1,"b":2} 和 {"b":2,"a":1} 的内容一样,缩进怎么写也没关系,都算相同。 如果内容一样、只是写法不同,页面会另外告诉你。

列表(数组)是怎么对比的?

默认按顺序一项一项比,因为在 JSON 里列表的顺序是有意义的。中间加了或删了一项时,只会显示那一项,例如在最前面加一项,只会显示“新增一项”,后面的项目不会全部变成“修改”。项目里的内容有改动时,列表会指出位置,例如 $.items[3].price。

“对比选项”里还有两种比法:

  • 按字段:某个字段(例如 "id")的值一样,就当成同一个项目,不管它排在第几个。换了位置的项目会标为“移动”,里面有改动的地方也会一起列出。可以用的字段会从你的文档自动找出来,也可以自己输入。
  • 不管顺序:完全不看项目的顺序,适合标签、权限这类列表。

如果有些差异看起来只是项目换了位置,页面会提示你可以改用哪一种比法。

怎么忽略时间这类每次都会变的字段?

有改动的字段如果看起来是时间或编号,页面会问你要不要忽略。你也可以在“对比选项”里自己写,一行一个:

  • updatedAt:所有叫这个名字的字段,不管在哪一层
  • meta.requestId:所有 meta 下面的 requestId
  • $.items[*].updatedAt:只有这个位置;[*] 代表列表里的每一项

忽略的字段两边都不会比,结果上方会标出当前忽略了哪些。

1 和 1.0 算一样吗?

默认不算。数字按原本的写法比,这样才不会漏掉任何差异。如果有些差异只是写法不同,页面会告诉你有几个,并让你改成“数字按数值比较”,这时 1、1.0、1e0 都算相同。

不管用哪一种,很长的数字都不会被四舍五入:12345678901234567890 和 12345678901234567891 一定算不同。用 JavaScript 内置的 JSON.parse 读取的工具会把这种数字四舍五入,可能把它们当成一样。 加了引号的 "1" 是文本,不是数字,所以和 1 比会标为“类型改变”。

其中一份文档有错误怎么办?

要先改好才会对比。输入框会变红、标出那一行,并说明错在哪里,例如 } 前面多了逗号,或用了单引号而不是双引号。

这里不会自动帮你修。如果工具偷偷修好,再告诉你“没有差异”,你可能会继续拿着别的程序读不了的文件去用。JSON 格式化工具能修复的错误,旁边会出现指向它的链接;它会修复并列出每一处改动。

文档可以多大?

几 MB 的文档也可以比。所有差异都会找出来(重复的会合成一组);列表最多显示前 1000 条,点“复制列表”可以拿到全部。两份文档有几千行不同时,左右并排会关掉,只留下列表。