如何在 Node.js 中按公共字段合并多个数组的数据

本文介绍如何将嵌套的二维用户数据数组，按 `class_id` 字段归并为结构清晰的分组对象数组，使用 `flat()` 和 `reduce()` 高效实现去嵌套、分组与重构。

在 Node.js（或现代 JavaScript 环境）中处理多层嵌套数组时，若需按某个公共字段（如 class_id）聚合数据，直接使用 map 或多层 for 循环容易出错——尤其当同一子数组内包含多个不同 class_id（如示例中第二层数组同时含 "Grade 2" 和 "Grade 3"）时，原逻辑会因硬编码索引（如 item[0].class_id）而失效。

推荐采用函数式、声明式的解决方案：先扁平化（flat()），再归约分组（reduce()），最后提取值（Object.values()）。该方法语义清晰、可读性强，且天然支持跨子数组的 class_id 合并。

以下是完整实现代码：

const data = [
  [
    { class_id: "Grade 1", roll_number: "1", name: "alex" },
    { class_id: "Grade 1", roll_number: "2", name: "bob" },
  ],
  [
    { class_id: "Grade 2", roll_number: "7", name: "peter" },
    { class_id: "Grade 3", roll_number: "6", name: "lia" },
    { class_id: "Grade 2", roll_number: "5", name: "mary" },
    { class_id: "Grade 3", roll_number: "1", name: "violet" },
  ],
];

const result = data
  .flat() // → 将二维数组转为一维：[{...}, {...}, {...}, ...]
  .reduce((acc, { class_id, roll_number, name }) => {
    // 若 acc 中尚无该 class_id 对应的键，则初始化为 { class_id, students: [] }
    acc[class_id] ??= { class_id, students: [] };
    // 将精简学生信息推入对应班级的 students 数组
    acc[class_id].students.push({ roll_number, name });
    return acc;
  }, {});

// 将分组对象（键为 class_id）转换为所需格式的数组
console.log(Object.values(result));
// 输出：
// [
//   { class_id: "Grade 1", students: [{ roll_number: "1", name: "alex" }, { roll_number: "2", name: "bob" }] },
//   { class_id: "Grade 2", students: [{ roll_number: "7", name: "peter" }, { roll_number: "5", name: "mary" }] },
//   { class_id: "Grade 3", students: [{ roll_number: "6", name: "lia" }, { roll_number: "1", name: "violet" }] }
// ]

✅ 关键优势说明：

• data.flat() 安全消除嵌套层级，避免手动遍历子数组；
• reduce() 配合空值合并赋值 ??=（ES2025+），简洁实现“存在即复用，不存在即新建”的分组逻辑；
• 解构赋值 { class_id, roll_number, name } 提升可读性与维护性；
• 最终 Object.values() 确保输出为标准数组，无需关心原始键名顺序（JavaScript 引擎保证 Object.keys/values 对插入顺序的稳定性）。

⚠️ 注意事项：

• 若需兼容 Node.js
• 若输入数据中 class_id 可能为 undefined 或空字符串，建议在 reduce 内添加校验（如 if (!class_id) return acc;）；
• 此方案时间复杂度为 O(n)，空间复杂度为 O(k)，其中 n 为总学生数，k 为唯一 class_id 数量，性能优异。

通过这一模式，你不仅能解决当前的班级分组需求，还可轻松扩展至其他按字段聚合的场景（如按部门、状态、日期等分组），是 Node.js 数据处理中的实用范式。