案例：多 Sheet 工作簿

后台报表经常需要一份文件包含多个主题的 Sheet。本案例用销售明细 + 人员花名册两个 mock 数据集生成多页工作簿。

Mock 数据预览（人员花名册）

Mock · 5 rows · seed 42

工号	姓名	部门	城市	职位	月薪	入职日期	状态
E1001	韩勇	人事部	杭州	工程师	35273	2023-04-23	leave
E1002	卫静	人事部	杭州	产品经理	18500	2023-11-01	active
E1003	赵勇	人事部	上海	设计师	9266	2018-07-11	active
E1004	尤杰	研发部	上海	测试	33809	2020-09-18	active
E1005	赵伟	销售部	深圳	产品经理	42209	2020-07-31	active

实现代码

import { exportExcel, StylePresets } from "@marcusok/excel-exporter";

// salesRows / staffRows：业务侧数据（由你的业务代码提供，此处省略取数过程），
// 字段分别与两个 sheet 的 columns 一一对应

const result = await exportExcel({
  filename: "部门经营快报-2026-Q3",
  sheets: [
    {
      name: "销售明细",
      freezeRows: 1,
      autoFilter: true,
      columns: [
        { prop: "orderId", label: "订单号", width: 18 },
        { prop: "product", label: "商品", width: 18 },
        {
          prop: "amount",
          label: "金额",
          width: 14,
          style: StylePresets.currency,
        },
      ],
      data: salesRows,
    },
    {
      name: "人员花名册",
      freezeRows: 1,
      columns: [
        { prop: "id", label: "工号", width: 10 },
        { prop: "name", label: "姓名", width: 12 },
        { prop: "dept", label: "部门", width: 12 },
        { prop: "position", label: "职位", width: 14 },
        {
          prop: "salary",
          label: "月薪",
          width: 14,
          style: StylePresets.currency,
        },
        {
          prop: "hiredAt",
          label: "入职日期",
          width: 12,
          format: { type: "date" },
        },
      ],
      data: staffRows,
    },
  ],
});

要点

• 每个 Sheet 独立定义列、样式与数据，互不影响；
• 总行数 = 各 Sheet 之和，auto 模式按总行数路由；
• Sheet 名称遵守 Excel 规则：≤ 31 字符、不含 : \ / ? * [ ]。