JSON 补丁工具

按 RFC 7396 把 Merge Patch 合并到原文档,或者根据修改前后的两个 JSON 生成 Merge Patch;也可以按 RFC 6902 逐条执行 JSON Patch 的 add、remove、replace、move、copy、test 操作,查看每一步的结果和出错的那一条。数据只在浏览器本地处理。

合并结果

    HTTP 请求写法

    两种补丁格式怎么选

    Merge Patch(RFC 7396)JSON Patch(RFC 6902)
    写法一个 JSON,写出要改的字段和新值一个操作数组,每项包含 op、path、value
    删除字段把字段设为 null{"op": "remove", "path": "/a"}
    修改数组只能整个替换数组可以插入、删除、替换某一项,/list/- 表示末尾
    设置 null 值不能(null 表示删除)可以
    条件检查不支持test 操作,值不符时整个补丁失败
    Content-Typeapplication/merge-patch+jsonapplication/json-patch+json
    • Merge Patch 规则:补丁中的对象逐层合并;值为 null 的字段从结果中删除;值不是对象时(包括数组)直接替换;补丁本身不是对象时,整个文档被替换。
    • JSON Patch 是原子的:按顺序执行,任何一条失败(如路径不存在、test 不通过),整个补丁都不应生效,本工具会标出失败的那一条。
    • 路径写法:JSON Patch 使用 JSON Pointer,/user/tags/0 表示 user.tags 的第一项;键名中的 ~ 写成 ~0,/ 写成 ~1。

    比较两个 JSON 并生成 JSON Patch,请用 JSON 对比。

    JSON 补丁工具常见问题

    JSON 补丁工具怎么使用?

    选择操作:应用 Merge Patch 时左侧填原文档、右侧填补丁;生成 Merge Patch 时左右分别填修改前后的文档;执行 JSON Patch 时右侧填操作数组。下方显示结果、每条操作的执行情况和 HTTP PATCH 请求写法。

    什么是 JSON Merge Patch?

    RFC 7396 定义的补丁格式,用一个 JSON 描述要修改的字段,值为 null 表示删除该字段。

    什么是 JSON Patch?

    RFC 6902 定义的补丁格式,用 add、remove、replace 等操作数组描述修改。

    HTTP PATCH 请求用哪种格式?

    两种都可以,用 Content-Type 区分:application/merge-patch+json 或 application/json-patch+json。

    怎么向数组末尾追加元素?

    使用 JSON Patch 的 add 操作,路径写成 /数组名/-。

    JSON 补丁工具的结果应怎样理解?

    JSON Patch 遇到失败的操作时整个补丁不生效,与规范一致;生成的 Merge Patch 无法表达把值设为 null 的修改。

    输入内容会保存或发给外部服务吗?

    JSON 数据只在浏览器本地处理,不会上传。

    没有结果或操作失败时先检查什么?

    JSON Patch 提示路径不存在时,检查路径是否以 / 开头、数组下标是否越界,键名中的 / 需要写成 ~1。

    相关工具

    JSON 对比 · JSON 树形查看器 · 代码对比工具 · cURL 命令生成器 · 全部开发工具