如何利用 Object.groupBy（ES2026）依据业务字段对数组进行高效分组

Object.groupBy() 一行代码实现数组分组，支持按字段或自定义逻辑生成分组键，返回以键为属性名、对应元素数组为值的对象。

直接用 Object.groupBy() 就行，一行代码搞定分组，不用再写冗长的 reduce。

按单个字段快速分组

适合大多数基础场景，比如按状态、角色、类型等字符串字段归类。

• 传入数组和一个返回分组键的回调函数，例如 user => user.role 或 order => order.status
• 返回值是一个普通对象，属性名是分组键（自动转为字符串），属性值是该组的元素数组
• 示例：把用户按角色分组

const users = [{ name: '张三', role: 'admin' }, { name: '李四', role: 'user' }, { name: '王五', role: 'admin' }];
const grouped = Object.groupBy(users, user => user.role);
// → { admin: [...], user: [...] }

按计算逻辑动态分组

不只是取字段，还能做判断、格式化、组合等处理，让分组更贴合业务需求。

• 回调中可写任意逻辑，比如按分数划等级、按日期截取年月、按金额区间分类
• 注意返回值会被当作对象属性名，所以非字符串类型会自动调用 toString()
• 示例：订单按金额区间分组

const orders = [{ id: 1, amount: 980 }, { id: 2, amount: 5200 }, { id: 3, amount: 12000 }];
const byRange = Object.groupBy(orders, o =>
  o.amount   o.amount );
// → { 小额: [...], 中额: [...], 大额: [...] }

兼容老环境的稳妥做法

如果项目还需支持旧版浏览器或 Node.js 低版本，加个轻量 polyfill 即可无缝使用。

• 检查是否原生支持：if (!Object.groupBy)
• 用 reduce 模拟实现，核心逻辑就是 acc[key] ??= [] 再 .push(item)
• 生产环境建议用 core-js 等成熟垫片库，避免自己维护边界情况

什么时候该用 Map.groupBy

当分组键不是字符串，而是对象、函数、Symbol 或 null/undefined 时，Object.groupBy 会失效（因为对象属性名只能是字符串或 Symbol，且 Symbol 不会自动匹配）。

• 此时改用 Map.groupBy()，它支持任意类型的键，并返回 Map 实例
• 例如：按某个对象引用本身分组，或按 new Date().getFullYear() 这类可能为数字的值分组
• 调用方式一致，只是构造结果不同：Map.groupBy(items, item => item.category)