什么是文本、JSON 与 YAML 结构化差异对比工具?
本工具支持纯文本逐行对比与 JSON/YAML 深度语义对比。在纯文本模式下,内容完全按原始字符与换行比对;在 JSON 与 YAML 模式下,工具会先解析语法树、递归排序对象键以消除属性顺序与缩进排版的干扰,并提供「字段语义对比 (JSONPath)」表格视图。语义视图会按路径(如 $.user.role)精确列出新增字段、删除字段、值修改与数据类型变更(如 string 变为 number),同时支持忽略指定动态字段(如 updatedAt、requestId)和无序数组比对。
如何使用差异对比工具
- 1在「对比类型」中选择文本、JSON 或 YAML。
- 2将变更前的内容粘贴到左侧「原始」输入框,变更后的内容粘贴到右侧「修改后」输入框。
- 3在 JSON 或 YAML 模式下,可按需填写要忽略的字段名(以逗号分隔,如 updatedAt, traceId)或勾选「忽略数组元素顺序」。
- 4在下方切换「并排对比」、「统一视图」或「字段语义对比 (JSONPath)」查看行级补丁或字段路径变更表。
- 5点击复制按钮即可导出标准 Unified Diff 补丁文本。
常见使用场景
接口 JSON 响应语义级比对
忽略 JSON 对象字段顺序并过滤 timestamp、requestId 等动态噪声字段,按 JSONPath 一目了然地排查接口返回值与字段类型变化。
Kubernetes 与 YAML 配置文件审查
按解析后的数据结构比对两份 YAML 配置清单,排除不同编辑器缩进或键排序不同带来的整屏标红误报。
代码审查与 Git Patch 补丁生成
对比修改前后的源代码并生成兼容 git apply 与 patch 命令的标准统一差异(Unified Diff)补丁。
文稿与合同修订追踪
逐行比对文档、技术说明或配置文件的不同版本,清晰定位每一处新增与删改。
常见问题
「字段语义对比 (JSONPath)」和普通行对比有什么区别?
普通行对比是在格式化并排序键名后按文本行比对;而「字段语义对比」会直接遍历解析后的 JSON/YAML 对象树,按路径(如 $.database.port)列出每一个新增、删除、值变更以及数据类型变化(例如字符串 "8080" 变成了数字 8080)。
对比 JSON 时可以自动忽略时间戳或请求 ID 吗?
可以。切换到 JSON 或 YAML 模式后,在「忽略字段名」输入框中填入用逗号分隔的键名(如 updatedAt, requestId),语义对比表就会自动跳过这些字段。
我的文本或 JSON 数据会上传到服务器吗?
不会。所有解析、键排序与结构化比对均在浏览器本地内存中完成,数据不会离开您的设备。
为什么两段肉眼看一样的文本在「文本」模式下全篇显示差异?
这通常由换行符不一致(Windows 的 CRLF 与 Linux/macOS 的 LF)或行尾不可见空格引起。如果是 JSON 或 YAML 数据,切换到对应的结构化模式即可彻底消除排版与换行符造成的虚假差异。