如何使用write-excel-file库映射对象数组生成Excel文件

核心问题原因 #

write-excel-file 仅支持扁平的一维数据结构，无法自动解析嵌套的子数组（比如你的benefits中的persons），直接传入嵌套数组会导致库无法识别有效行数据，因此生成的Excel为空。

解决方案：手动展开嵌套数组 #

需要先将嵌套的persons子数组展开，把每个人员条目与所属的福利信息合并为一条扁平数据，再传入库生成Excel。

修改后的代码示例 #

// 原始嵌套数据示例
const benefits = [
  {
    id: 1,
    name: "健康保险",
    persons: [
      { name: "张三", age: 30 },
      { name: "李四", age: 28 }
    ]
  },
  {
    id: 2,
    name: "年终奖金",
    persons: [
      { name: "王五", age: 35 }
    ]
  }
];

// 展开嵌套数组，生成扁平数据
const flattenedData = benefits.flatMap(benefit => {
  // 为每个person条目关联所属福利的信息
  return benefit.persons.map(person => ({
    benefitId: benefit.id,
    benefitName: benefit.name,
    personName: person.name,
    personAge: person.age
  }));
});

// 定义Excel列映射
const columns = [
  { column: "福利ID", value: row => row.benefitId },
  { column: "福利名称", value: row => row.benefitName },
  { column: "人员姓名", value: row => row.personName },
  { column: "人员年龄", value: row => row.personAge }
];

// 调用write-excel-file生成Excel
writeExcelFile(flattenedData, {
  columns,
  fileName: "福利人员报表.xlsx"
});

替代Excel导出库推荐 #

如果write-excel-file的功能无法满足复杂场景需求，推荐以下几个常用库：

• xlsx（SheetJS）：功能全面，支持多种Excel格式（.xlsx/.xls等），能灵活处理嵌套数据、自定义单元格样式，社区文档完善，适合大多数场景。
• exceljs：支持流式导出，适合处理大数据量报表，提供丰富的样式定制（字体、颜色、边框等），还支持读取和修改现有Excel文件。
• react-excel-renderer + file-saver：React生态中常用组合，react-excel-renderer负责数据转Excel结构，file-saver处理文件下载，上手简单。

内容的提问来源于stack exchange，提问作者marcinb1986