JSON 结构对比
按路径逐层对比,直接指出哪个字段变了
如何使用本工具
- 左边贴旧 JSON,右边贴新 JSON,点对比(也可以直接改内容,结果会实时刷新)。
- 差异表按 JSONPath 列出每处不同的路径,变化列标注新增、删除、修改、类型变化或数组长度变化。
- 接口返回变化时用这个比纯文本 diff 准得多:键顺序不同不会误报,只会报真正变了的字段。
- 数组元素顺序不重要时勾上「数组按值匹配」,否则按索引逐项对比。
- 「严格区分 1 与 \"1\"」关掉后,数字和同值字符串视为相同,适合排查后端改了字段类型但值没变的情况。
常见问题
Q:为什么纯文本 diff 不适合比 JSON?
A:JSON 的键顺序在语义上无关紧要,但文本 diff 会把重排当成整段改动;缩进、空格、换行风格一变也会满屏红色。结构化对比先解析再逐路径比较,能直接告诉你 data.user.name 变了,而不是第 47 行到第 92 行都变了。
Q:数组按值匹配有什么副作用?
A:它只做值层面的集合比较,不关心位置。所以 [1,2,3] 变成 [2,3,1] 会被判为「完全一致」,而元素内部只改了一个字段的对象也会被当成删除加新增,而不是修改。看顺序敏感的数据(比如分页列表)时不要开。
Q:类型变化和值变化为什么要分开报?
A:因为处理方式完全不同。值变了通常只是数据更新;类型从数字变成字符串,往往意味着后端序列化改了、或者字段被塞了空字符串,前端可能直接报错。把类型单独标出来,排查时一眼能看到。
Q:JSONPath 里的 $ 是什么意思?
A:$ 表示根节点,.key 表示对象属性,[0] 表示数组下标。这套记法来自 JSONPath 规范,jq、Postman、各种断言库都认,复制到别处也能直接用。
Q:能比多大的 JSON?
A:几 MB 的接口返回没问题,递归深度只受浏览器栈限制(通常几千层)。超大文件(几十 MB)建议先在命令行用 jq 或专门的 diff 工具处理,浏览器解析和渲染都会明显卡。
Q:两份 JSON 一样但仍显示有差异?
A:检查三点:数字精度(1.0 和 1 在 JS 里都是 number,但文本不同)、键的顺序(本工具不敏感,但如果嵌套在字符串里就不一样了)、以及是否开了严格类型而一边是 \"null\" 字符串一边是真的 null。