JS对象数组怎么根据指定属性去重

作者:闭包旅人

时间:2026-11-22

浏览:380

说明JavaScript中对象数组按指定属性去重的常用写法,涵盖Map保留首条或最后一条、Set配合filter、reduce及普通对象注意事项、多属性联合去重与选型依据。

文章目录

在 JavaScript 中,给对象数组按指定属性去重,最稳妥、常用的做法是使用 Map 或 Set 配合 filter():需要保留最后一次出现的对象时用 Map 直接覆盖写入,只需要保留第一次出现的对象时用 Set 记录已出现过的属性值并过滤。下面按实际使用场景拆解这几种写法、适用边界以及容易踩坑的地方。

JS对象数组怎么根据指定属性去重
缩略图:按指定属性去重的核心思路——以目标属性值作为唯一标识完成过滤或覆盖

为什么不能直接用 new Set(arr) 去重

处理数字或字符串数组时,很多人习惯直接写 [...new Set(arr)],但这一招对对象数组无效。原因在于 JavaScript 中的对象属于引用类型,Set 判断两个元素是否重复时比较的是内存引用地址,而不是对象内部的属性值。

哪怕两个对象的 id 和 name 完全一样,只要它们不是同一个对象引用(例如接口分别返回的两条记录,或先后生成的两个字面量对象),new Set(arr) 就会认为它们互不相同,最终一条都不会删掉。

因此,对象数组按指定属性去重的本质是:把需要判重的属性值(比如 item.id)提取出来当作键,利用 Map 或 Set 对键进行唯一性检查,再决定保留哪一个对象。

方法一:使用 Map 去重(推荐,可灵活保留首条或末条)

Map 支持任意类型的键名,且会严格按照插入顺序保存键值对,时间复杂度为 O(n),是目前最通用的写法。根据业务需要保留“首次出现”还是“最后一次出现”,只需要调整写入 Map 的条件即可。

1. 保留最后一次出现的对象(后覆盖前)

如果数组中后面的数据更新、需要以最后一条为准,可以直接遍历数组并调用 map.set(item[key], item)。相同键名再次写入时,新对象会自动覆盖旧对象,同时保留第一次建立该键时的顺序位置。

以下代码可在现代浏览器控制台或 Node.js 环境下直接运行:

const users = [
  { id: 1, name: '林青', role: '编辑' },
  { id: 2, name: '周宁', role: '审核' },
  { id: 1, name: '林青', role: '主编' },
  { id: 3, name: '陈默', role: '访客' }
];

function uniqueByLast(arr, key) {
  const map = new Map();
  for (const item of arr) {
    map.set(item[key], item);
  }
  return Array.from(map.values());
}

const resultLast = uniqueByLast(users, 'id');
console.log(resultLast);
示例输出:
[
  { id: 1, name: '林青', role: '主编' },
  { id: 2, name: '周宁', role: '审核' },
  { id: 3, name: '陈默', role: '访客' }
]

如果你喜欢更紧凑的写法,也可以利用 Map 构造函数接收二维键值对数组的特性,一行写成 [...new Map(arr.map(item => [item[key], item])).values()],逻辑与上面的循环完全等价。

2. 保留第一次出现的对象(先入为主)

如果希望保留最先出现的对象、忽略后续重复项,只需在写入前多加一步 !map.has(val) 判断:

function uniqueByFirst(arr, key) {
  const map = new Map();
  for (const item of arr) {
    const prop = item[key];
    if (!map.has(prop)) {
      map.set(prop, item);
    }
  }
  return Array.from(map.values());
}

const resultFirst = uniqueByFirst(users, 'id');
console.log(resultFirst);
示例输出:
[
  { id: 1, name: '林青', role: '编辑' },
  { id: 2, name: '周宁', role: '审核' },
  { id: 3, name: '陈默', role: '访客' }
]
JS对象数组怎么根据指定属性去重
图 1:使用 Map 对对象数组按指定属性去重的四步操作流程及保留策略分支

方法二:使用 Set 配合 filter()(语义清晰,保留首次出现)

如果确定只需要保留第一次出现的对象,Set 配合 Array.prototype.filter() 的可读性更好:Set 只用来记录“已经见过的属性值”,filter() 负责构造新数组。

下面是一个完整的示例,同时加入了空值保护,避免数组中意外混入 null 或非对象元素时直接报错:

const products = [
  { sku: 'A101', title: '键盘' },
  { sku: 'A102', title: '鼠标' },
  { sku: 'A101', title: '机械键盘' },
  { sku: 'A103', title: '显示器' }
];

function uniqueWithSet(arr, key) {
  const seen = new Set();
  return arr.filter(item => {
    if (item == null || typeof item !== 'object') {
      return false;
    }
    const val = item[key];
    if (seen.has(val)) {
      return false;
    }
    seen.add(val);
    return true;
  });
}

console.log(uniqueWithSet(products, 'sku'));
示例输出:
[
  { sku: 'A101', title: '键盘' },
  { sku: 'A102', title: '鼠标' },
  { sku: 'A103', title: '显示器' }
]
提醒:Set 只能记录“出现过没有”,无法像 Map 那样直接通过同一个键去替换之前已经放进结果数组里的对象。因此,如果你的需求是“保留最后一条”,不要硬改 Set + filter,直接换回方法一的 Map 更简洁。
JS对象数组怎么根据指定属性去重
图 2:Map 与 Set + filter() 在内部存储结构及重复项处理上的区别

方法三:用 reduce() 配合 Map 或普通对象(以及普通对象的坑)

在老项目里,经常能看到用 reduce() 搭配一个普通对象 {} 来记录已出现键名的写法。如果坚持用 reduce(),也建议把记录表换成 Map 或 Set,不要用普通对象 {}。

// 不推荐:用普通对象 {} 做哈希表,存在类型隐式转换隐患
const objMap = {};
const badResult = list.reduce((acc, item) => {
  if (!objMap[item.id]) {
    objMap[item.id] = true;
    acc.push(item);
  }
  return acc;
}, []);

上面这段代码有两个容易忽略的问题:

  • 数字和字符串会被混为一谈:普通对象的键只能是字符串或 Symbol。如果数组里一条数据的 id 是数字 1,另一条的 id 是字符串 '1',在 objMap 里它们都会变成键名 "1",导致两条不同类型的数据被误判为重复。而 Map 和 Set 会严格区分 1 和 '1'。
  • 原型链键名冲突风险:如果某个对象的属性值恰好是 'toString' 或 'constructor',!objMap['toString'] 会因为读取到 Object.prototype.toString 而返回 false,导致正常数据被错误跳过(除非改用 Object.create(null))。

如果团队习惯函数式链式写法,用 reduce() 配合 Map 即可避开上述问题:

function uniqueByReduce(arr, key) {
  return Array.from(
    arr.reduce((map, item) => {
      if (!map.has(item[key])) {
        map.set(item[key], item);
      }
      return map;
    }, new Map()).values()
  );
}

实际开发中的边界情况与多属性去重

套用上面几个模板之前,有四类边界情况在实际业务数据里非常常见,处理不好容易出现漏删或误删。

1. 多个属性联合去重

有时候单个属性不够唯一,比如需要同时根据“部门 dept”和“姓名 name”两个属性去重。最常见的错误写法是用短横线拼接字符串:`${item.dept}-${item.name}`。

这样拼有碰撞风险:dept: "a-b", name: "c" 和 dept: "a", name: "b-c" 拼出来都是 "a-b-c",会被错误合并。更稳妥的写法是用 JSON.stringify 序列化属性数组,或封装一个接收回调函数 getKey(item) 的通用函数:

const members = [
  { dept: '研发', name: '张敏', level: 'P6' },
  { dept: '产品', name: '张敏', level: 'P6' },
  { dept: '研发', name: '张敏', level: 'P7' }
];

function uniqueByKeyFn(arr, getKey) {
  const seen = new Set();
  return arr.filter(item => {
    const key = getKey(item);
    if (seen.has(key)) {
      return false;
    }
    seen.add(key);
    return true;
  });
}

// 传入联合键生成函数,避免分隔符碰撞
const uniqueMembers = uniqueByKeyFn(
  members,
  item => JSON.stringify([item.dept, item.name])
);
console.log(uniqueMembers);
示例输出:
[
  { dept: '研发', name: '张敏', level: 'P6' },
  { dept: '产品', name: '张敏', level: 'P6' }
]

2. 嵌套属性(例如 item.user.id)

如果目标属性不在第一层,而是嵌套在子对象里,使用上面的 uniqueByKeyFn 搭配可选链即可:item => item.user?.id,不需要写死只能传单层属性名。

3. 属性值缺失(undefined 或 null)

当数组中有多个对象都缺少目标属性(item[key] 为 undefined)时,Map 和 Set 会把所有 undefined 视为同一个键,结果只保留其中一条。如果你的业务要求“没有该属性的对象不能互相去重,全部保留”,需要在过滤前单独放行:

function uniqueKeepMissing(arr, key) {
  const seen = new Set();
  return arr.filter(item => {
    const val = item?.[key];
    if (val === undefined || val === null) {
      return true; // 缺失属性的数据不参与去重,直接保留
    }
    if (seen.has(val)) {
      return false;
    }
    seen.add(val);
    return true;
  });
}

4. 属性值为 NaN 或需要忽略大小写

Map 和 Set 内部使用接近严格相等的算法(SameValueZero)判断键是否相等,在这个规则下 NaN 与 NaN 会被视为相同键,不会出现 NaN !== NaN 导致去重失败的情况。如果是邮箱、标签等文本属性需要忽略大小写去重,只需在取键时统一转成小写,例如 String(item.email).trim().toLowerCase()。

JS对象数组怎么根据指定属性去重
图 3:对象数组按属性去重时容易忽视的四类边界条件及对应处理方案

实际开发怎么选

把几种写法放到具体需求里对比,选择标准其实很明确:

  • 希望保留最新(最后一条)数据:直接用 Map(map.set(item[key], item)),最后 Array.from(map.values())。
  • 希望保留第一条数据,追求代码直观:用 Set 配合 filter(),逻辑一眼就能看懂,也方便往里面加空值放行判断。
  • 需要按嵌套属性或多属性联合去重:把第二个参数从属性名改成键生成函数 getKey(item),结合 Set 或 Map 统一处理。
  • 尽量避开的写法:用双重 for 循环或 findIndex() 在每次迭代里从头查找(时间复杂度会退化到 O(n²),数据量上千时明显变慢),以及用普通对象 {} 当作判重字典。
JS对象数组怎么根据指定属性去重
图 4:JS 对象数组按指定属性去重各方案的保留策略、复杂度与适用场景汇总

实用工具推荐

电子包浆

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

使用 ›
图片压缩

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

使用 ›
相关文章