JS对象数组怎么根据指定属性去重
说明JavaScript中对象数组按指定属性去重的常用写法,涵盖Map保留首条或最后一条、Set配合filter、reduce及普通对象注意事项、多属性联合去重与选型依据。
在 JavaScript 中,给对象数组按指定属性去重,最稳妥、常用的做法是使用 Map 或 Set 配合 filter():需要保留最后一次出现的对象时用 Map 直接覆盖写入,只需要保留第一次出现的对象时用 Set 记录已出现过的属性值并过滤。下面按实际使用场景拆解这几种写法、适用边界以及容易踩坑的地方。
为什么不能直接用 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: '访客' }
]
方法二:使用 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 更简洁。
方法三:用 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()。
实际开发怎么选
把几种写法放到具体需求里对比,选择标准其实很明确:
- 希望保留最新(最后一条)数据:直接用
Map(map.set(item[key], item)),最后Array.from(map.values())。 - 希望保留第一条数据,追求代码直观:用
Set配合filter(),逻辑一眼就能看懂,也方便往里面加空值放行判断。 - 需要按嵌套属性或多属性联合去重:把第二个参数从属性名改成键生成函数
getKey(item),结合Set或Map统一处理。 - 尽量避开的写法:用双重
for循环或findIndex()在每次迭代里从头查找(时间复杂度会退化到O(n²),数据量上千时明显变慢),以及用普通对象{}当作判重字典。
Chrome与Firefox在JS事件循环实现上有哪些差异?
2026-11-22 19:39:09
JavaScript怎么统计包含Symbol和不可枚举属性的对象大小
2026-11-22 18:50:44
用JavaScript编写支持括号优先级的科学计算器逻辑
2026-11-22 16:41:45
JavaScript对象取值:点号与方括号表示法的区别及用法
2026-11-22 16:18:10
JS数组按索引删除元素:splice方法参数详解
2026-11-22 15:34:21
相关标签:








