JavaScript怎么按值移除数组中的指定元素

作者:半夏

时间:2026-11-19

浏览:338

详细讲解在 JavaScript 中如何按值移除数组中的指定元素。涵盖保留原数组的不可变方案(filter、toSpliced)与就地修改方案(indexOf + splice、倒序循环),深入分析索引偏移与对象比对等常见边界问题。

文章目录

一、核心认知:按值移除的两大决策点

在编写代码前,开发者必须明确两个关键前提,否则很容易引入难以排查的状态污染或漏删 Bug:

  1. 是否允许原地修改原数组(Mutation)? 在现代前端框架(如 React、Vue 等)的状态管理中,通常要求遵守“数据不可变”原则,即生成新数组而不是修改旧数组;而在部分对性能、内存占用要求严格的算法或底层工具中,原地修改效率更高。
  2. 仅移除第一个匹配值,还是移除所有重复出现的相同值? 数组中可能包含多个重复元素(例如 [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' ]
JavaScript怎么按值移除数组中的指定元素
图 2:原地修改 (splice) 与生成新数组 (filter) 的内存与引用行为对比

三、原地修改原数组:就地删除的方法

当需要直接更新原数组、节约重新分配内存的开销时,可以使用 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() 中负数索引表示从数组末尾倒数计算,会导致数组的最后一个元素被无辜删除!
JavaScript怎么按值移除数组中的指定元素
图 3:indexOf + splice 原地移除指定值的操作步骤图解

2. 移除全部匹配项:倒序遍历与 while 循环

如果要原地删除数组中所有等于目标值的元素,很多初学者会写出正向 for (let i = 0; i < arr.length; i++) 并在内部执行 splice,这会导致严重的“漏项 Bug”。

因为每执行一次 splice(i, 1),后面的元素就会自动向前移动一个位置(索引值减 1),紧接着循环步进 i++,正好把刚刚位移过来的下一个元素跳过了。

JavaScript怎么按值移除数组中的指定元素
图 4:正向遍历元素位移漏检陷阱与倒序遍历避坑原理

稳妥方案 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))在性能上明显占优。

六、决策树与方法对照总结

在实际编码中,建议按照以下决策流选择最适合的方法:

JavaScript怎么按值移除数组中的指定元素
图 5:JavaScript 数组按值移除元素最佳选型与决策流程
需求场景 推荐方法 是否修改原数组 时间复杂度 适用场景
移除所有相同值 arr.filter(...) 否(新数组) O(n) 现代框架、不可变数据流首选
只移除首个相同值 arr.toSpliced(...) / slice 否(新数组) O(n) 队列处理、不破坏原引用的单项删除
原地删除首个相同值 indexOf + splice 是(原地修改) O(n) 内存敏感、单例管理、常规就地修改
原地删除全部相同值 倒序 for 循环 + splice 是(原地修改) O(n²) 最坏 不想开辟新内存且元素数量适中的场景
对象数组按属性删除 findIndex + splice / filter 依实现而定 O(n) 列表项具有唯一 ID 或主键时的标准做法

实用工具推荐

电子包浆

绿化、压缩、噪点和虚拟水印,自由调节做旧程度。

使用 ›
图片压缩

选择画质和输出格式,预览压缩前后的大小。

使用 ›
相关文章