JSON 合并

相关推荐

什么是 JSON 合并（JSON Merge）？

适用场景

• OpenAPI 文档聚合：后端把多个微服务的 Swagger/OpenAPI JSON 用深度合并生成统一 API 网关入口。
• K8s 部署配置合并：运维把 Helm values.yaml、ConfigMap、Secret 三份 JSON 按环境栈式深度合并，输出最终部署清单。
• 单元测试 Fixture 拼接：QA 把基础数据集 JSON 与多个边界场景 JSON 用数组拼接策略合并，构造完整测试输入。
• 日志离线分析：数据分析师把 ELK 或 Kafka 多分区导出的多条 JSON 日志合并为单文件，便于统计与差异对比。
• 前端依赖清单整合：把多个子项目的 package.json 用数组拼接 + 去重合并 dependencies 字段，输出统一依赖清单。
• 多渠道客服会话归档：把微信、邮件、Web 表单多渠道聊天记录 JSON 合并为统一会话档案，便于后续检索分析。
• 数据契约链路：先经 JSON 修复清洗脏数据，再在本工具按深度策略合并，最后用 Schema 校验结果作为接口契约。
• 前后端联调：把后端多份接口响应 JSON 合并后，喂给 JSON 转 TypeScript 工具生成前端强类型定义。
• 跳过空值合并：把含 null 的覆盖 JSON 与有效配置用深度合并加跳过 null 策略合并，避免有效字段被 null 清空。
• 图表配置个性化：把 ECharts 基础配置 JSON 与用户自定义 series JSON 深度合并，渲染出符合产品需求的图表。
• Feature Flag 覆盖：产品把默认功能开关 JSON 与灰度实验配置用数组替换策略合并，让后输入的实验值覆盖基线值。
• 竞品差异对比准备：把本地 JSON 与抓取的竞品 JSON 用数组拼接合并后送入 diff 工具，快速定位字段差异。

使用方法

1. 将 2 到 N 段需要合并的 JSON 依次粘贴到左侧输入框（默认 2 个），或点击「+」添加更多输入
2. 在工具栏下拉框中选择合并策略：深度合并（Deep）/ 浅层合并（Shallow）/ 数组拼接（Array Concat）/ 数组替换（Array Replace）
3. 点击「合并」按钮，右侧输出框会显示合并后的格式化结果；如输入有语法错误会显示具体行号和报错信息
4. 确认结果无误后点击「复制」把合并结果放入剪贴板，或点击「下载」保存为 merged.json 文件继续做格式化、Schema 校验等后续处理

功能特点

• 4 种合并策略：深度合并 / 浅层合并 / 数组拼接 / 数组替换，可一键切换满足不同业务场景
• 支持 2 到 N 段 JSON：默认 2 个输入框，可点「+」动态添加更多源 JSON，灵活适配多源聚合
• 深度递归合并：智能处理多层嵌套对象，对叶子节点冲突按指定策略处理，保留所有有效字段
• 灵活冲突解决：顶层冲突时按所选策略执行；嵌套对象冲突时进入深层合并；数组冲突时按 arrayConcat/arrayReplace 区分处理
• 输出统一格式化：合并结果以 2 空格缩进显示，便于人工审阅和直接复制到下游工具
• 实时合并执行：粘贴完成点击「合并」即得结果，错误时显示具体 JSON 行号和报错信息
• 本地处理保护隐私：解析、合并、格式化全部在浏览器本地完成，输入内容不发送到任何服务器
• 无缝衔接下游：合并结果可一键复制到 JSON 格式化、Schema 校验、代码生成等工具中继续处理

代码示例

// npm install lodash.merge
import merge from 'lodash.merge';

const a = { user: { name: 'Alice', age: 28 }, tags: ['admin'] };
const b = { user: { email: 'a@x.com', age: 29 }, tags: ['editor'] };

// 深度合并: 嵌套对象递归合并, 叶子节点后输入覆盖前值
const deep = merge({}, a, b);
console.log(deep);
// => { user: { name: 'Alice', age: 29, email: 'a@x.com' }, tags: ['admin', 'editor'] }

// 浅层合并: 顶层键整段覆盖, 不进入嵌套
const shallow = Object.assign({}, a, b);
console.log(shallow);
// => { user: { email: 'a@x.com', age: 29 }, tags: ['editor'] }

# pip install mergedeep
from mergedeep import merge

a = {"user": {"name": "Alice", "age": 28}, "tags": ["admin"]}
b = {"user": {"email": "a@x.com", "age": 29}, "tags": ["editor"]}

# 深度合并
result = merge(a, b)
print(result)
# => {'user': {'name': 'Alice', 'age': 29, 'email': 'a@x.com'}, 'tags': ['admin', 'editor']}

# 注意: mergedeep 默认数组合并, 字符串/数字覆盖
# 如需数组覆盖, 加 strategy='override'

# 把多个 JSON 数组合并成一个长数组
jq -s 'add' a.json b.json c.json

# 把多个 JSON 对象递归合并 (jq 1.6+)
jq -s 'reduce .[] as $item ({}; . * $item)' a.json b.json

# 浅层合并: 把 b 顶层键覆盖到 a
jq -s '.[0] * .[1]' a.json b.json

# 数组合并后只保留去重后的 id 字段
jq -s '[.[].items[]] | unique_by(.id)' a.json b.json

常见问题

故障排查

术语表

JSON Merge

把两个或多个 JSON 对象按指定规则合并成一个新对象的操作，核心难点是"键名冲突时的解决策略"。

Deep Merge / 深度合并

递归进入嵌套对象、对每个叶子节点分别合并的策略；两边都是普通对象时递归，否则按覆盖处理。

Shallow Merge / 浅层合并

只合并顶层键、同名键整段覆盖的策略；JS 中等价于 `Object.assign({}, a, b)`。

Array Concat / 数组拼接

数组合并策略之一：把多个数组合并成一个长数组并保留所有元素顺序；常用于 API 响应聚合。

Array Replace / 数组替换

数组合并策略之一：同名数组以后输入的为准整段覆盖；常用于配置覆盖。

Object.assign

JavaScript 内置方法，把所有可枚举自有属性从一个或多个源对象浅拷贝到目标对象；浅合并的事实标准实现。

lodash.merge

Lodash 库提供的深度合并函数，是 Node.js 生态最常用的 deep merge 实现；数组合并而非覆盖。

mergedeep (Python)

Python 生态的深度合并库，pip install mergedeep；支持 strategy 参数控制数组合并/覆盖行为。

jq -s 'add'

jq 命令把多个 JSON 数组相加为单一数组；多个 JSON 对象合并需用 `reduce .[] as $item ({}; . * $item)`。

BFF (Backend for Frontend)

在微服务架构中位于前端和后端服务之间的聚合层；常需要把多个服务的 JSON 响应合并成统一响应，是 JSON 合并的经典场景。

4 种 JSON 合并策略对比

常见 JSON 合并实现对照表

Authoritative References

• MDNObject.assign - MDN Web 文档
• LodashLodash _.merge 官方文档
• jqjq 官方手册 - reduce 与 add
• IETFJSON 官方规范 (RFC 8259)