多场景对练数据的 Excel 横向导出方案（EasyExcel 动态表头实践）

一、背景

在日常开发中，我们经常需要将复杂的场景数据导出成 Excel 文件，方便运营或培训人员查看。

比如“客户与学员对练场景”这种数据，原始结构大致如下：

• 多个场景（List<LearnHouseScene2Vo>）

• 每个场景里有 若干轮对话（List<SceneItem>）

一个 SceneItem 就是一轮对话：

• 客户节点

• 客户话术

• 学员节点

• 学员标准话术

• 关键词

需求：
希望在 Excel 中导出成：

• 每个场景占 5 列（客户节点、客户话术、学员节点、学员标准话术、关键词）

• 多个场景横向拼接

• 每行对应第几轮对话，不足的用空白填充

二、需求分析

举个例子：

• 场景1 有 2 轮

• 场景2 有 3 轮

期望的 Excel：

三、解决方案

1. 动态表头
   每个场景占 5 列，表头通过循环生成，使用 EasyExcel 的多级表头功能。

2. 数据行构造

   • 先计算所有场景的最大对话轮数 maxRow

   • 遍历 0 ~ maxRow-1，每一行拼接所有场景的对应对话

   • 不足的补空字符串

四、实体类

@Data
public class SceneItem {

    @ExcelProperty("客户节点")
    private String customerNode;
    @ExcelProperty("客户话术")
    private String customerScript;
    @ExcelProperty("学员节点")
    private String studentNode;
    @ExcelProperty("学员标准话术")
    private String studentScript;
    @ExcelProperty("关键词")
    private String keyword;
}

@Data
public class LearnHouseScene2Vo {

    // 存储动态数量的场景组
    private List<SceneItem> sceneItems = new ArrayList<>();

    /**
     * 向当前场景组中追加一个对话节点
     */
    public void addSceneItem(SceneItem item) {
        sceneItems.add(item);
    }

}

五、工具类实现

import com.alibaba.excel.EasyExcel;

import java.io.OutputStream;
import java.util.ArrayList;
import java.util.Arrays;
import java.util.List;

public class SceneExcelExporter {

    /**
     * 导出场景对练数据到 Excel
     *
     * @param scenes 多个场景
     * @param out    输出流
     */
    public static void export(List<LearnHouseScene2Vo> scenes, OutputStream out) {
        List<List<String>> head = buildHead(scenes);
        List<List<String>> data = buildData(scenes);

        EasyExcel.write(out)
                .head(head)
                .sheet("场景对练")
                .doWrite(data);
    }

    /**
     * 构造动态表头
     */
    private static List<List<String>> buildHead(List<LearnHouseScene2Vo> scenes) {
        List<List<String>> head = new ArrayList<>();
        for (int i = 0; i < scenes.size(); i++) {
            int idx = i + 1;
            head.add(Arrays.asList("场景" + idx, "客户节点"));
            head.add(Arrays.asList("场景" + idx, "客户话术"));
            head.add(Arrays.asList("场景" + idx, "学员节点"));
            head.add(Arrays.asList("场景" + idx, "学员标准话术"));
            head.add(Arrays.asList("场景" + idx, "关键词"));
        }
        return head;
    }

    /**
     * 构造数据行
     */
    private static List<List<String>> buildData(List<LearnHouseScene2Vo> scenes) {
        int maxRow = scenes.stream()
                .mapToInt(vo -> vo.getSceneItems().size())
                .max().orElse(0);

        List<List<String>> rows = new ArrayList<>();
        for (int r = 0; r < maxRow; r++) {
            List<String> row = new ArrayList<>();
            for (LearnHouseScene2Vo vo : scenes) {
                if (r < vo.getSceneItems().size()) {
                    SceneItem item = vo.getSceneItems().get(r);
                    row.add(item.getCustomerNode());
                    row.add(item.getCustomerScript());
                    row.add(item.getStudentNode());
                    row.add(item.getStudentScript());
                    row.add(item.getKeyword());
                } else {
                    // 补空白
                    row.add(""); row.add(""); row.add(""); row.add(""); row.add("");
                }
            }
            rows.add(row);
        }
        return rows;
    }
}

六、使用方式

List<LearnHouseScene2Vo> scenes = findUrlGetSPBlockingData3(url); // 解析后的场景数据
try (OutputStream out = new FileOutputStream("场景对练.xlsx")) {
    SceneExcelExporter.export(scenes, out);
}

七、总结

• 核心点：多场景横向导出，本质是动态生成表头 + 按行拼接数据。

• 通用性：这个 SceneExcelExporter 工具类可以复用在任何类似的“多组相同字段横向导出”需求中。

• 扩展点：如果需要在 Excel 顶部加一行大标题，可以在 EasyExcel 写出前用 POI 或者在 head 中加额外层级。