JSON 智能对比
左右双栏 · 增删改高亮 · 文本/可视化
智能对比
就绪
ABOUT
关于 JSON 智能对比
对比两段 JSON 的结构与内容差异，支持可视化高亮和文本报告两种模式，帮助快速发现 API 响应变更。
版本发布前核对 API 契约、排查配置漂移、验证 Mock 数据更新——Diff 是开发者最高频的 JSON 操作之一。JSONSort 在本地完成对比，两份数据都不会离开你的设备。
DEEP DIVE
深入了解 JSON 智能对比
API 版本迭代、配置热更新、A/B 测试回归——开发者经常需要回答「这两份 JSON 到底哪里不同」。纯文本 diff 对 JSON 不友好：字段顺序变化、缩进差异都会产生大量噪音。JSONSort 智能对比按 JSON 结构语义比较，增删改高亮清晰可读。
工具提供可视化双栏 Diff 和纯文本报告两种输出。可视化模式适合快速浏览，文本报告适合粘贴到 Pull Request 描述或 Jira 工单中留档。
对比算法基于解析后的 JSON 抽象语法树，而非逐行文本 diff。这意味着单纯调整缩进或键顺序不会产生误报；真正的新增、删除与值变更才会高亮显示，适合作为 Code Review 与发布 checklist 的辅助工具。
FEATURES
核心能力
左右双栏输入
左侧为基准版本，右侧为对比版本，符合直觉的操作布局。
可视化高亮
新增字段绿色、删除红色、修改黄色，结构变化一目了然。
文本 Diff 报告
可切换为纯文本 diff 输出，方便复制到文档或 IM。
结构语义对比
按 JSON 键值语义比较，减少无意义的空白/顺序噪音。
本地运行
两份 JSON 均不上传，适合对比含敏感数据的接口响应。
即时刷新
任一侧输入变化后自动重新对比，无需手动点击按钮。
Summary 摘要
输出变更统计与路径级摘要，便于写入 PR 描述。
双模式切换
可视化与文本报告一键切换，满足不同协作习惯。
HOW TO USE
使用步骤
-
1
在左右两栏分别粘贴 JSON
-
2
选择可视化或文本 Diff 模式
-
3
查看高亮差异并复制报告
-
4
在顶部选项栏调整缩进、JSON5、排序等高级设置
-
5
一键复制结果，或继续用 Diff / 路径提取等工具深入分析
WORKFLOW
典型工作流
从导入数据到导出结果的完整流程，帮助团队统一 JSON 智能对比 的使用方式。
准备两份 JSON
左侧放基准版本（旧接口/生产配置），右侧放待对比版本。
预格式化
可选：两侧分别格式化，减少因空白导致的阅读干扰。
选择 Diff 模式
快速浏览用可视化；需要留档用文本报告。
确认变更
根据高亮逐项确认是否为预期变更，复制 summary 到 PR。
USE CASES
适用场景
后端开发
Review API v1 → v2 响应结构变更，确认字段废弃与新增。
测试工程师
回归测试时对比实际返回与预期 JSON 的差异。
DevOps
对比两次部署之间的 ConfigMap JSON 配置变化。
前端开发
Mock 数据更新后，Diff 确认哪些字段影响组件渲染。
API 产品
对比文档示例与真实接口返回，确保文档与实现一致。
配置管理员
发布前后对比 Nacos / Apollo 导出的 JSON 配置差异。
TIPS
使用技巧
- 对比前先分别用格式化工具整理两份 JSON，Diff 结果更干净。
- 大型 JSON 建议先去掉不关心的字段（用合并清理工具），再对比核心部分。
- 文本报告模式输出的 summary 可直接作为 changelog 素材。
- 数组元素按索引比较，若只关心集合内容不关心顺序，需先做排序预处理。
- 可视化模式下左右两栏可独立滚动，方便对照同一层级的字段。
- 接口联调时，把 Postman 两次响应分别粘贴左右栏，秒级出 diff。
- 对比 v1/v2 接口时，建议先分别保存为文件便于反复 Diff。
- 仅关心部分字段时，可先用路径提取取出子树再对比。
- 文本报告适合 attach 到 Slack / 飞书工单作为变更记录。
- 两侧 JSON 大小悬殊时，先确认是否拿错了环境的数据。
LOCAL VS ONLINE
本地 vs 在线工具
JSONSort 坚持纯前端架构，以下对比说明为何本地化工具更适合处理开发数据。
TROUBLESHOOTING
常见误区与排查
实际使用中容易遇到的问题及建议处理方式，减少反复试错的时间。
Diff 结果噪音过多
建议：两侧先格式化并按键排序；或删除 timestamp 等必然变化的字段。
数组元素对不上
建议：数组按索引对比，若只关心集合内容需先排序或提取 id 映射。
一侧解析失败
建议：先用格式化工具修复语法错误，确保两侧均为合法 JSON。
看起来一样但有差异
建议：检查 hidden 字段类型差异（字符串 "123" vs 数字 123）。
FAQ
常见问题
数组顺序不同算差异吗？
会按索引位置逐元素对比，顺序变化会显示为修改或增删。
能对比 JSON 和 JSON5 吗？
可以。两侧输入独立解析，解析成功后按 JSON 结构对比。
可视化 Diff 能导出吗？
文本报告模式下的 summary 和 diff 内容可复制导出。
左右两侧必须都是合法 JSON 吗？
是的。若任一侧语法错误，会先提示解析失败及错误行。
浮点数精度差异算变更吗？
会。0.1 + 0.2 等浮点表示差异会如实显示，必要时先做数值归一化。
能否忽略某些字段？
当前全量对比。可先手动删除不关心的键，或用合并工具预处理。
数据会上传到服务器吗？
不会。JSONSort 所有工具均在浏览器本地运行，您的输入内容不会发送到任何后端服务器。
需要注册或安装吗？
不需要。打开页面即可使用，无需账号、无需下载客户端，也支持 PWA 离线缓存。
支持多大的文件？
取决于浏览器内存，通常可流畅处理数 MB 级别的数据。超大文件建议先拆分或使用合并清理工具。