JSON 对比工具
粘贴两份 JSON,看清楚哪里改了。 不用先设置:换个比法会更清楚时,页面会提示你。
三个步骤
- 左边粘贴原始的 JSON。
- 右边粘贴修改后的 JSON。
- 差异会自动显示在这里。
怎么使用
粘贴两份数据
左边放原始版本,右边放修改后的版本。可以粘贴、直接输入,或把 .json 文件拖到任一边。 没有“对比”按钮:边输入,结果边更新。
看差异列表
每一行是一个差异:发生了什么(新增、删除、修改),以及在哪里。 点一下那一行,就会跳到“左右并排”里对应的位置。
跟着提示走
如果项目只是换了位置,或是时间字段造成一堆干扰,会出现蓝色提示,建议更合适的比法。点一下就应用,再点一下就取消。
看懂对比结果
第一次用也没关系。下面说明页面上每个词的意思。
- 什么是 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 条,点“复制列表”可以拿到全部。两份文档有几千行不同时,左右并排会关掉,只留下列表。