JavaScript怎么按值移除数组中的指定元素
详细讲解在 JavaScript 中如何按值移除数组中的指定元素。涵盖保留原数组的不可变方案(filter、toSpliced)与就地修改方案(indexOf + splice、倒序循环),深入分析索引偏移与对象比对等常见边界问题。
一、核心认知:按值移除的两大决策点
在编写代码前,开发者必须明确两个关键前提,否则很容易引入难以排查的状态污染或漏删 Bug:
- 是否允许原地修改原数组(Mutation)? 在现代前端框架(如 React、Vue 等)的状态管理中,通常要求遵守“数据不可变”原则,即生成新数组而不是修改旧数组;而在部分对性能、内存占用要求严格的算法或底层工具中,原地修改效率更高。
- 仅移除第一个匹配值,还是移除所有重复出现的相同值? 数组中可能包含多个重复元素(例如
[1, 2, 2, 3]中移除2),单次切除与批量过滤需要完全不同的控制逻辑。
二、不修改原数组:生成新数组的方法
如果希望保持原始数组完整无副作用,应通过生成过滤后的新数组来完成移除。
1. 移除全部匹配项:filter()(现代开发最推荐做法)
Array.prototype.filter() 接受一个测试函数,返回所有通过测试的新元素集合。将测试条件设为“不等于目标值”,即可轻松将所有匹配项剔除:
// 准备原始测试数组
const fruits = ['apple', 'banana', 'orange', 'banana', 'pear'];
const target = 'banana';
// 移除所有 'banana',生成新数组
const updatedFruits = fruits.filter(item => item !== target);
console.log('新数组:', updatedFruits);
console.log('原数组未受影响:', fruits);
新数组: [ 'apple', 'orange', 'pear' ]
原数组未受影响: [ 'apple', 'banana', 'orange', 'banana', 'pear' ]
filter() 具有纯函数特性,代码简洁且链式调用非常顺畅,适用于大部分业务场景。
2. 仅移除首个匹配项:toSpliced() 或 slice() 拼接
如果只需要移除第一个匹配项而保留后续同值项,可以使用 indexOf() 先定位到首个下标,再结合切片方式生成新数组:
const list = ['a', 'b', 'c', 'b', 'd'];
const target = 'b';
const index = list.indexOf(target);
let singleRemovedList;
if (index !== -1) {
// 现代方案:ES2023 Array.prototype.toSpliced
singleRemovedList = list.toSpliced(index, 1);
// 传统兼容方案(ES6展开运算符与slice)
// singleRemovedList = [...list.slice(0, index), ...list.slice(index + 1)];
} else {
singleRemovedList = [...list];
}
console.log('结果:', singleRemovedList);
结果: [ 'a', 'c', 'b', 'd' ]
三、原地修改原数组:就地删除的方法
当需要直接更新原数组、节约重新分配内存的开销时,可以使用 splice() 系列操作。
1. 仅移除首个匹配项:indexOf() + splice()
这是最经典的实现方式。步骤分为三步:通过 indexOf() 获取下标、校验下标是否存在、执行 splice() 切除。
const colors = ['red', 'green', 'blue', 'green'];
const targetColor = 'green';
// 第一步:查找目标值的首次出现下标
const targetIndex = colors.indexOf(targetColor);
// 第二步:必须确认元素存在
if (targetIndex !== -1) {
// 第三步:从 targetIndex 处删除 1 个元素
colors.splice(targetIndex, 1);
}
console.log('原数组直接变化:', colors);
原数组直接变化: [ 'red', 'blue', 'green' ]
targetIndex !== -1!如果目标元素不存在于数组中,
indexOf() 会返回 -1。如果不加判断直接调用 colors.splice(-1, 1),在 splice() 中负数索引表示从数组末尾倒数计算,会导致数组的最后一个元素被无辜删除!
2. 移除全部匹配项:倒序遍历与 while 循环
如果要原地删除数组中所有等于目标值的元素,很多初学者会写出正向 for (let i = 0; i < arr.length; i++) 并在内部执行 splice,这会导致严重的“漏项 Bug”。
因为每执行一次 splice(i, 1),后面的元素就会自动向前移动一个位置(索引值减 1),紧接着循环步进 i++,正好把刚刚位移过来的下一个元素跳过了。
稳妥方案 A:倒序 for 循环(从后往前扫描)
倒序遍历从数组最后一个元素向前检查,即使后方元素被删除,也不会改变前方待检查元素的下标:
const numbers = [1, 2, 2, 3, 2, 4];
const removeVal = 2;
// 从 length - 1 倒序循环至 0
for (let i = numbers.length - 1; i >= 0; i--) {
if (numbers[i] === removeVal) {
numbers.splice(i, 1);
}
}
console.log('完全清除重复项:', numbers);
完全清除重复项: [ 1, 3, 4 ]
稳妥方案 B:while 循环结合 indexOf 动态查找
const tags = ['js', 'css', 'html', 'js', 'node', 'js'];
let idx;
// 循环定位目标值,直到找不到 (-1) 为止
while ((idx = tags.indexOf('js')) !== -1) {
tags.splice(idx, 1);
}
console.log('清除所有匹配项:', tags);
清除所有匹配项: [ 'css', 'html', 'node' ]
四、引用类型:对象数组按属性值移除
如果数组内包含的是普通对象(例如 [{ id: 1 }, { id: 2 }]),由于 JavaScript 中对象比较的是内存引用地址,直接使用 indexOf({ id: 1 }) 永远会返回 -1。
针对这类结构,应该使用带有判定回调函数的 API:
1. 原地移除指定对象:findIndex() + splice()
const userList = [
{ id: 101, name: 'Alice' },
{ id: 102, name: 'Bob' },
{ id: 103, name: 'Charlie' }
];
// 根据 id 查找索引
const targetId = 102;
const userIndex = userList.findIndex(user => user.id === targetId);
if (userIndex !== -1) {
userList.splice(userIndex, 1);
}
console.log('删除后用户列表:', userList);
删除后用户列表: [ { id: 101, name: 'Alice' }, { id: 103, name: 'Charlie' } ]
2. 生成新数组:filter() 匹配属性
const activeUsers = userList.filter(user => user.id !== targetId);
五、常见避坑点与易错场景
- 切忌使用
delete arr[index]移除元素:delete运算符只会将该位置的值设为undefined(在控制台中显示为empty slot),数组的length并不会减少,会形成稀疏数组。 - 元素为
NaN时的判定失效: 在严格全等规则下NaN === NaN为false,因此indexOf(NaN)始终返回-1。若要移除NaN,应使用findIndex(Number.isNaN)或arr.filter(x => !Number.isNaN(x))。 - 超大数组下的性能考量:
splice()是O(n)操作,若在长数组中循环调用splice()会引发多次内存搬迁,总体时间复杂度达到O(n²)。数据量达到数万级且要批量删除时,单次线性扫描的filter()(时间复杂度O(n))在性能上明显占优。
六、决策树与方法对照总结
在实际编码中,建议按照以下决策流选择最适合的方法:
| 需求场景 | 推荐方法 | 是否修改原数组 | 时间复杂度 | 适用场景 |
|---|---|---|---|---|
| 移除所有相同值 | arr.filter(...) |
否(新数组) | O(n) | 现代框架、不可变数据流首选 |
| 只移除首个相同值 | arr.toSpliced(...) / slice |
否(新数组) | O(n) | 队列处理、不破坏原引用的单项删除 |
| 原地删除首个相同值 | indexOf + splice |
是(原地修改) | O(n) | 内存敏感、单例管理、常规就地修改 |
| 原地删除全部相同值 | 倒序 for 循环 + splice |
是(原地修改) | O(n²) 最坏 | 不想开辟新内存且元素数量适中的场景 |
| 对象数组按属性删除 | findIndex + splice / filter |
依实现而定 | O(n) | 列表项具有唯一 ID 或主键时的标准做法 |
JavaScript中的8种数据类型详解
2026-11-19 22:35:28
用JavaScript生成平滑彩虹色谱数组的算法
2026-11-19 22:21:26
JS生成指定范围的不重复随机数数组
2026-11-19 22:02:30
JavaScript是值传递还是引用传递
2026-11-19 20:44:24
JavaScript函数默认参数的基本语法与写法
2026-11-19 19:40:15








