工程实践
把 JSON 放进真实系统：接口契约怎么定、配置与夹具怎么管、版本兼容怎么做、测试数据怎么维护。
5 篇文章本分类文章
两份 JSON 差在哪：按位置比、按 id 比、还是先归一化
50 条数据插进 1 条，为什么对比工具报了 51 处差异？讲清文本 diff 在 JSON 上的三类误报、数组按位置与按 id 的取舍、jq 归一化命令，以及比出差异后怎么变成可应用的补丁。
入门约 6 分钟更新于 2026-10-30
JSON 文件的 Git 冲突：union 会写出坏 JSON，按 key 合并才对
两个分支各加一个文案键，Git 却报冲突，于是有人加上 merge=union 一行了事。实测下来，union 会让缺逗号的 JSON 通过合并、让重复键静默覆盖、让单行 JSON 变成两份文档，而 Git 全程认为「合并成功」。这篇给出按键三方合并的驱动写法，以及三个能让冲突变少的前置习惯。
进阶约 7 分钟更新于 2026-10-30
JSON 契约的版本演进：兼容、弃用与数据迁移
给接口加字段不等于安全，破坏性变更往往藏在类型与语义里。这篇给出可执行的版本演进路径：兼容边界、版本字段与媒体类型、弃用窗口、消费者排查、双写迁移与回滚、契约测试，以及灰度发布的观察指标。
实战约 10 分钟更新于 2026-10-31