本文介绍如何将两个结构相似但 ID 键名不同的对象数组（如 id 与 levelId）合并为一个无重复项的新数组，并自动将 levelId 统一转换为 id，确保数据一致性与可维护性。
本文介绍如何将两个结构相似但 id 键名不同的对象数组（如 `id` 与 `levelid`）合并为一个无重复项的新数组，并自动将 `levelid` 统一转换为 `id`，确保数据一致性与可维护性。
在实际开发中，我们常遇到多个数据源返回结构相近但字段命名不一致的对象数组（例如后端不同接口使用 id 和 levelId 表达同一语义的唯一标识）。此时若需合并去重并标准化字段，不能简单使用 concat + Set，而需基于业务主键（这里是 ID 值）进行逻辑判重与字段映射。
核心思路是：以第一个数组为基础，遍历第二个数组，对每个元素检查其 levelId 是否已在第一个数组中存在对应 id；若不存在，则构造新对象（将 levelId 映射为 id），并追加到结果中。
以下为推荐实现方案（ES6+，纯函数、无副作用）：
function mergeArraysByUnifiedId(baseArray, incomingArray, idKey = 'id', sourceIdKey = 'levelId') {
const baseIdSet = new Set(baseArray.map(item => item[idKey]));
return [
...baseArray,
...incomingArray
.filter(item => !baseIdSet.has(item[sourceIdKey]))
.map(item => ({
[idKey]: item[sourceIdKey],
value: item.value,
label: item.label,
level: item.level
}))
];
}
// 使用示例
const arr1 = [
{ id: 'ABC_123', value: 10, label: 'tree', level: 'mid' },
{ id: 'ABC_456', value: 11, label: 'grass', level: 'top' }
];
const arr2 = [
{ levelId: 'ABC_123', value: 10, label: 'tree', level: 'mid' },
{ levelId: 'ABC_456', value: 11, label: 'grass', level: 'top' },
{ levelId: 'ABC_789', value: 11, label: 'bush', level: 'low' }
];
const merged = mergeArraysByUnifiedId(arr1, arr2);
console.log(merged);
// 输出：
// [
// { id: 'ABC_123', value: 10, label: 'tree', level: 'mid' },
// { id: 'ABC_456', value: 11, label: 'grass', level: 'top' },
// { id: 'ABC_789', value: 11, label: 'bush', level: 'low' }
// ]
✅ 优势说明：
- 使用
Set预构建 ID 索引，时间复杂度优化至 O(n + m)，避免嵌套循环； - 支持自定义
idKey和sourceIdKey，适配不同命名场景（如code/itemId等）； - 返回全新数组，不修改原始输入，符合函数式编程原则；
- 显式声明映射字段，便于后续扩展（如增加
createdAt或过滤其他属性）。
⚠️ 注意事项：
- 确保
idKey和sourceIdKey在各自数组中均存在且类型一致（建议均为字符串）； - 若需深度合并（如相同 ID 下部分字段取较新值），应改用
reduce+findIndex实现覆盖逻辑； - 生产环境建议增加参数校验（如
Array.isArray()）和空值防护。
该方法简洁、高效、可复用，是处理多源异构数组标准化合并的典型实践。
