JS添加数组元素时怎么不修改原数组
详细讲解JavaScript在数组末尾、开头和指定索引位置添加元素且不修改原数组的具体方法,涵盖展开运算符、concat、slice拼接、toSpliced以及对象数组的浅拷贝注意事项。
在 JavaScript 中添加数组元素且不修改原数组,核心做法是放弃直接调用 push()、unshift() 或 splice(),改用会创建并返回新数组的语法或方法。最常用的三种方式是:使用展开运算符 [...arr, newItem] 在开头或末尾追加元素、使用 arr.concat(newItem) 合并生成新数组,以及使用 slice() 组合或 ES2023 新增的 toSpliced() 在指定索引位置插入元素。下面按插入位置、底层引用机制和实际开发场景逐一说明具体写法与注意事项。
一、为什么常规添加方法会修改原数组
JavaScript 中的数组属于引用类型(Object)。当我们把一个数组赋值给变量时,变量里保存的并不是数组元素本身,而是指向堆内存中那块连续结构的内存地址。传统的 push()、unshift() 和 splice() 设计初衷是“原地修改(In-place Mutation)”:它们直接顺着内存地址找到原数组,在原内存空间上追加或移动元素,因此所有指向该地址的变量都会同步发生变化。
很多场景下我们必须保留原数组不变。例如在保留历史记录以支持“撤销/重做”、对比修改前后的数据差异,或者在 React、Vue、Redux 等依赖引用地址变化来触发视图更新的前端框架中,直接原地修改会导致新旧引用完全相同(oldArr === newArr 为 true),进而引发界面不刷新或原始基准数据被污染的问题。
二、按插入位置选择不修改原数组的添加方法
实际写代码时,向数组添加元素无非三种位置:添加到末尾、添加到开头、插入到中间某个索引。选对与位置匹配的方法,代码既简短又不容易写错索引。以下示例均可直接在浏览器控制台(DevTools Console)或 Node.js(建议 v20 及以上环境)中运行验证。
1. 在数组末尾添加元素(替代 push)
要在数组末尾追加一个或多个元素且不影响原数组,最直观的做法是使用 ES6 展开运算符(...)或数组的 concat() 方法。展开运算符会把原数组中的全部元素按顺序浅拷贝到一个新的数组字面量中,紧接着放入新元素。
// 运行环境:浏览器 Console 或 Node.js
const fruits = ["apple", "banana"];
// 方式一:使用展开运算符追加单个或多个元素
const addedBySpread = [...fruits, "orange", "pear"];
// 方式二:使用 concat() 方法追加元素
const addedByConcat = fruits.concat("orange");
console.log("原数组 fruits:", fruits);
console.log("展开运算符结果:", addedBySpread);
console.log("concat 结果:", addedByConcat);
console.log("引用是否不同:", fruits !== addedBySpread);
["x", "y"] 作为一个整体嵌套放进末尾),fruits.concat(["x", "y"]) 会默认把这层数组拍平,得到 ["apple", "banana", "x", "y"]。此时应优先使用展开运算符 [...fruits, ["x", "y"]],才能准确把子数组作为单个元素追加进去。
2. 在数组开头添加元素(替代 unshift)
当需要把新元素放在第 0 个位置时,只需把新元素写在数组字面量的最前面,随后展开原数组即可;如果使用 concat(),则是用一个包含新元素的临时数组去调用 concat(原数组)。
// 运行环境:浏览器 Console 或 Node.js
const steps = ["校验参数", "发送请求"];
// 方式一:将新元素写在展开运算符前面
const withInitStep = ["初始化配置", ...steps];
// 方式二:用新数组连接原数组
const withInitByConcat = ["初始化配置"].concat(steps);
console.log("原数组 steps:", steps);
console.log("前置展开结果:", withInitStep);
console.log("concat 前置结果:", withInitByConcat);
3. 在数组中间指定索引处插入元素(替代 splice)
在指定下标 index 处插入元素是最容易误改原数组的场景,因为很多人习惯直接写 arr.splice(index, 0, item)。要避免修改原数组,有两种可靠写法:
- 使用
toSpliced(start, deleteCount, ...items)(ES2023 标准方法):参数与splice()完全一致,第二个参数传0表示不删除任何元素,直接返回插入新元素后的新数组,原数组丝毫不变。 - 使用
slice()分段配合展开运算符(兼容所有旧环境):先用arr.slice(0, index)截取前半段,放上新元素后,再用arr.slice(index)拼接后半段。
// 运行环境:Node.js 20+ 或现代浏览器(Chrome 110+ / Edge 110+ / Safari 16+ / Firefox 115+)
const chapters = ["第一章", "第三章", "第四章"];
const insertIndex = 1; // 准备在索引 1 的位置插入“第二章”
// 方式一:使用 ES2023 的 toSpliced(起始索引, 删除个数0, 新增元素)
const updatedByToSpliced = chapters.toSpliced(insertIndex, 0, "第二章");
// 方式二:使用 slice 分段拼接(兼容不支持 ES2023 的旧环境)
const updatedBySlice = [
...chapters.slice(0, insertIndex),
"第二章",
...chapters.slice(insertIndex)
];
console.log("原数组 chapters:", chapters);
console.log("toSpliced 结果:", updatedByToSpliced);
console.log("slice 拼接结果:", updatedBySlice);
toSpliced(),可以在执行前通过 typeof Array.prototype.toSpliced === "function" 进行判断;若返回 false,直接使用上方的 slice() 分段拼接方案即可。
三、关键边界:数组元素是对象时的“浅拷贝”陷阱
前面介绍的展开运算符、concat()、slice() 和 toSpliced() 都能保证外层数组容器是全新的,因此往新数组里增删元素绝不会改变原数组的长度和排列。但它们执行的都是浅拷贝(Shallow Copy)。
这意味着:如果原数组里存放的是对象或子数组(例如 [{ id: 1, done: false }]),新数组里的前几个元素仍然和原数组指向内存中同一个对象引用。如果我们在添加新元素的同时,顺手修改了数组中某个已有对象的属性,原数组里的对应对象也会跟着被修改。
下面通过一段完整代码对比“仅添加新对象”与“添加并修改旧对象内部属性”时的具体表现及隔离方法:
// 运行环境:Node.js 17+ 或现代浏览器
const users = [{ id: 1, role: "editor" }];
// 1. 仅添加新对象:直接使用展开运算符即可,原数组不会受影响
const nextUsers = [...users, { id: 2, role: "viewer" }];
console.log("仅添加后原数组长度:", users.length);
// 2. 如果后续要直接修改新数组中已有元素(如索引0)的内部属性,使用 structuredClone 隔离
const deepIsolatedUsers = [...structuredClone(users), { id: 2, role: "viewer" }];
deepIsolatedUsers[0].role = "admin";
console.log("原数组 users[0].role:", users[0].role);
console.log("深拷贝新数组 deepIsolatedUsers[0].role:", deepIsolatedUsers[0].role);
四、方法选型对比与常见问题排查
为了在日常编码时快速决定用哪一种写法,可以根据插入位置、是否需要合并数组以及运行环境要求参考下表:
| 目标操作 | 推荐写法(不修改原数组) | 对应会修改原数组的方法 | 适用条件与特点 |
|---|---|---|---|
| 在末尾添加元素 | [...arr, item] |
arr.push(item) |
语法最直观,支持同时追加多个元素或保留子数组结构 |
| 在末尾合并另一个数组 | arr.concat(otherArr) 或 [...arr, ...otherArr] |
arr.push(...otherArr) |
concat 在处理超长数组拼接或旧版 ES5 环境时兼容性好 |
| 在开头添加元素 | [item, ...arr] |
arr.unshift(item) |
书写顺序与最终元素排列顺序完全一致,可读性高 |
在指定索引 i 插入 |
arr.toSpliced(i, 0, item) |
arr.splice(i, 0, item) |
ES2023 原生支持,语义清晰,无需手动写两段 slice |
在指定索引 i 插入(旧环境) |
[...arr.slice(0, i), item, ...arr.slice(i)] |
arr.splice(i, 0, item) |
无 ES2023 环境限制,所有主流浏览器与 Node 版本均支持 |
常见问题排查
问题 1:为什么我写了 arr.concat("新元素"),打印 arr 发现元素根本没加进去?
原因在于非破坏性方法不会改动调用者本身,而是把添加后的结果作为函数返回值交出来。如果只调用不接收,生成的新数组会直接被丢弃。必须写成 const newArr = arr.concat("新元素"),后续使用 newArr;如果原变量用 let 声明且希望更新变量指向,也需要显式写成 arr = [...arr, "新元素"]。
问题 2:为什么用 const newArr = arr.push("新元素") 接收后,newArr 变成了一个数字?
Array.prototype.push() 和 unshift() 的返回值定义就是“修改后数组的新长度(Number)”,而不是数组本身。想要拿到新数组且不改原数组,应把 arr.push(item) 替换为 [...arr, item]。
问题 3:在循环里频繁执行 res = [...res, item] 添加上万条数据为什么会变慢?
每次执行 [...res, item] 都会重新分配一块内存并把已有元素全部复制一遍,在循环次数很大(例如上万次)时时间复杂度会退化为平方级。如果只是在同一个函数内部组装新数组,可以先对原数组做一次浅拷贝(const res = [...originalArr]),在循环内部对这个新副本调用 res.push(item),循环结束后再返回 res。这样既保证了原数组 originalArr 不被修改,又避免了循环内的重复复制开销。
JavaScript数组sort()默认按字符串排序的陷阱与修正
2026-11-18 23:42:05
JS数组末尾追加元素:push方法与展开运算符用法
2026-11-18 23:30:12
JS手动解析自定义格式日期字符串的方法
2026-11-18 22:59:25
从执行上下文看JS变量提升的底层原理
2026-11-18 22:00:22
JS怎么获取对象的不可枚举属性及Symbol属性
2026-11-18 21:01:38








