本文介绍如何安全、高效地根据指定字段（如 name）对数组中的对象进行覆盖或新增操作，避免直接修改原数组，并支持批量处理多个待更新对象。
本文介绍如何安全、高效地根据指定字段（如 name）对数组中的对象进行覆盖或新增操作，避免直接修改原数组，并支持批量处理多个待更新对象。
在前端开发中，常需动态更新配置项、表单字段或列表数据——例如根据唯一标识（如 name 或 id）批量覆盖已有项，并自动追加新项。若直接修改原数组（如使用 findIndex + push），不仅违背函数式编程原则，还易引发意外副作用（如响应式系统失效、引用污染）。更优解是采用**不可变更新策略**：基于 Map 构建键值索引，一次性完成查、替、增，最后生成全新数组。
以下为推荐实现：
const replaceOrAdd = (sourceArray, overrideArray, key = "name") => {
// 步骤1：将 sourceArray 转为 Map，以 item[key] 为键，item 为值
const sourceMap = new Map();
sourceArray.forEach(item => sourceMap.set(item[key], item));
// 步骤2：遍历 overrideArray，逐个 set 到 Map —— 相同 key 自动覆盖，新 key 自动新增
overrideArray.forEach(item => sourceMap.set(item[key], item));
// 步骤3：将 Map 转回数组（保持插入顺序，且无重复）
return Array.from(sourceMap.values());
};
✅ 优势说明：
-
无副作用：不修改
sourceArray原始引用，符合 React/Vue 等框架的最佳实践； -
高性能：
Map查找/插入时间复杂度为 O(1)，整体为 O(n + m)，远优于多次findIndex的 O(n×m)； -
批量友好：支持一次传入多个待更新对象（如示例中的
replace数组），逻辑清晰； -
顺序保留：
Map迭代顺序遵循插入顺序，原始项位置优先，新增项自然追加至末尾（符合预期输出）。
⚠️ 注意事项：
Java Maven Common
下载
Java Maven 项目审查工作流的通用输入处理。当 Java Maven 项目以 ZIP压缩包或 GitLab 仓库 URL 形式提供且需要...时使用。
- 确保
key字段在每个对象中存在且唯一，否则后插入的同 key 对象会覆盖前者； - 若需严格保持原始数组顺序（如新增项必须插在特定位置），则需改用
reduce+filter组合方案； - 在 TypeScript 项目中，建议为参数添加类型约束，例如
Array<record unknown>></record>。
调用示例结果完全匹配预期：
console.log(replaceOrAdd(source, replace));
// 输出包含 5 个对象：前 4 个为 source 基础结构，其中 'job_order_number' 和 'booking_number' 的 visible 已更新为 false，末尾新增 { label: "XXXXX", name: "XXXXXX", visible: false }
该模式可轻松扩展为通用工具函数（如封装进工具库），亦适用于状态管理（Redux Toolkit 的 createEntityAdapter 思路即源于此类逻辑）。坚持“输入不变、输出新值”，是构建可预测、易测试前端逻辑的关键一步。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
