EasyExcel单元格合并功能详解：LoopMergeStrategy实战-优快云博客

EasyExcel单元格合并功能详解：LoopMergeStrategy实战

【免费下载链接】easyexcel 快速、简洁、解决大文件内存溢出的java处理Excel工具项目地址: https://gitcode.com/gh_mirrors/ea/easyexcel

1. 痛点直击：Excel合并单元格的"三宗罪"

你是否还在为以下Excel合并问题头疼？

手工合并效率低下，1000行数据需重复操作数十次
Apache POI原生API复杂，合并逻辑需手写20+行代码
动态数据合并时出现错位，固定区域合并方案不适用

本文将系统讲解EasyExcel中最强大的循环合并策略——LoopMergeStrategy，通过10+代码示例和3种实战场景，帮你彻底解决批量数据合并难题。读完本文你将掌握：

注解式与编程式两种合并实现方式
动态数据自适应合并的核心算法
合并冲突处理与性能优化技巧

2. 核心原理：LoopMergeStrategy工作机制

2.1 类结构解析

mermaid

2.2 核心参数说明

参数名	类型	含义	约束
eachRow	int	合并行数	必须>1
columnExtend	int	合并列数	必须>1
columnIndex	int	起始列索引	从0开始

合并规则公式：当前行索引 % eachRow == 0时触发合并，合并范围为[当前行, 当前行+eachRow-1]行 × [columnIndex, columnIndex+columnExtend-1]列

3. 快速上手：3种实现方式对比

3.1 注解式实现（推荐）

// 数据模型定义
public class OrderData {
    @ExcelProperty("订单号")
    private String orderId;
    
    @ExcelProperty("客户名称")
    private String customerName;
    
    @ContentLoopMerge(eachRow = 2, columnExtend = 1)
    @ExcelProperty("产品分类")
    private String productCategory;
    
    @ExcelProperty("销售金额")
    private BigDecimal amount;
}

// 写入代码
EasyExcel.write("merge_demo.xlsx", OrderData.class)
         .sheet("订单数据")
         .doWrite(dataList);

3.2 编程式实现（灵活控制）

// 创建合并策略
LoopMergeStrategy mergeStrategy = new LoopMergeStrategy(3, 2, 2); // 每3行合并，合并2列，从第3列开始

// 写入时注册策略
EasyExcel.write("merge_demo.xlsx", OrderData.class)
         .registerWriteHandler(mergeStrategy)
         .sheet("订单数据")
         .doWrite(dataList);

3.3 混合模式（复杂场景）

// 模型注解定义基础合并
public class OrderData {
    // ...其他字段
    
    @ContentLoopMerge(eachRow = 2, columnExtend = 1)
    @ExcelProperty("产品分类")
    private String productCategory;
}

// 代码中动态调整
EasyExcel.write("merge_demo.xlsx", OrderData.class)
         .registerWriteHandler(new LoopMergeStrategy(4, 1, 3)) // 额外对第4列设置4行合并
         .sheet("订单数据")
         .doWrite(dataList);

4. 实战场景：从基础到高级

4.1 场景一：相同数据自动合并

需求：将相同订单号的行进行合并，形成分组效果

// 1. 准备测试数据
List<OrderData> dataList = new ArrayList<>();
dataList.add(new OrderData("ORD001", "客户A", "电子产品", new BigDecimal("1200.00")));
dataList.add(new OrderData("ORD001", "客户A", "电子产品", new BigDecimal("800.00")));
dataList.add(new OrderData("ORD002", "客户B", "办公用品", new BigDecimal("300.00")));
dataList.add(new OrderData("ORD002", "客户B", "办公用品", new BigDecimal("500.00")));
dataList.add(new OrderData("ORD002", "客户B", "办公用品", new BigDecimal("200.00")));

// 2. 自定义合并策略
class DynamicMergeStrategy extends LoopMergeStrategy {
    private String lastOrderId;
    private int mergeCount = 1;
    
    public DynamicMergeStrategy() {
        super(1, 1, 0); // 初始值，后续会动态调整
    }
    
    @Override
    public void afterRowDispose(RowWriteHandlerContext context) {
        OrderData data = (OrderData)context.getRowData();
        if (data.getOrderId().equals(lastOrderId)) {
            mergeCount++;
        } else {
            if (mergeCount > 1) {
                // 执行合并前一组
                CellRangeAddress region = new CellRangeAddress(
                    context.getRowIndex() - mergeCount, 
                    context.getRowIndex() - 1, 0, 0);
                context.getWriteSheetHolder().getSheet().addMergedRegionUnsafe(region);
            }
            mergeCount = 1;
            lastOrderId = data.getOrderId();
        }
    }
}

// 3. 应用策略
EasyExcel.write("dynamic_merge.xlsx", OrderData.class)
         .registerWriteHandler(new DynamicMergeStrategy())
         .sheet("动态合并")
         .doWrite(dataList);

4.2 场景二：报表标题多级合并

// 组合策略实现复杂报表头
EasyExcel.write("report.xlsx", ReportData.class)
         .registerWriteHandler(new OnceAbsoluteMergeStrategy(0, 1, 0, 3)) // 标题行合并
         .registerWriteHandler(new LoopMergeStrategy(2, 1, 1)) // 分类列合并
         .registerWriteHandler(new LoopMergeStrategy(3, 2, 4)) // 数据列合并
         .sheet("销售报表")
         .doWrite(reportData);

4.3 场景三：大数据量分批合并

// 处理10万行数据的内存优化方案
try (ExcelWriter writer = EasyExcel.write("big_data_merge.xlsx", BigData.class).build()) {
    WriteSheet sheet = EasyExcel.writerSheet("大数据合并").build();
    
    // 分批写入，每批5000行
    for (int i = 0; i < 20; i++) {
        List<BigData> batchData = fetchBatchData(i * 5000, 5000);
        writer.write(batchData, sheet);
    }
    
    // 后处理合并（关键）
    Sheet sheet = writer.writeContext().writeSheetHolder().getSheet();
    for (int i = 0; i < 100000; i += 5) { // 每5行合并
        if (i + 4 < 100000) {
            sheet.addMergedRegionUnsafe(new CellRangeAddress(i, i + 4, 0, 0));
        }
    }
}

5. 高级技巧与避坑指南

5.1 合并冲突解决方案

当多个合并策略作用于同一区域时，采用后注册优先原则。建议按以下顺序注册：

// 正确顺序：先列合并，后行合并，最后全局样式
writer.registerWriteHandler(columnMergeStrategy)  // 列合并策略
      .registerWriteHandler(rowMergeStrategy)     // 行合并策略
      .registerWriteHandler(cellStyleStrategy);   // 单元格样式策略

5.2 性能优化建议

场景	优化方案	性能提升
10万行+数据	采用后处理合并而非RowWriteHandler	约300%
多列独立合并	使用多个LoopMergeStrategy实例	避免逻辑混乱
Web导出场景	配合SXSSF模式写入	内存占用降低90%

5.3 常见错误排查

// 错误示例：参数设置不当导致合并失败
new LoopMergeStrategy(1, 1, 0); // 错误：eachRow和columnExtend不能同时为1

// 正确示例
new LoopMergeStrategy(2, 1, 0); // 每2行合并1列

// 错误示例：列索引越界
new LoopMergeStrategy(2, 3, 5); // 当只有5列时(0-4)，设置columnIndex=5会越界

6. 源码深度解析

6.1 核心方法剖析

// LoopMergeStrategy核心逻辑
@Override
public void afterRowDispose(RowWriteHandlerContext context) {
    // 跳过表头行和相对行索引为空的情况
    if (context.getHead() || context.getRelativeRowIndex() == null) {
        return;
    }
    
    // 关键判断：当前行是否需要触发合并
    if (context.getRelativeRowIndex() % eachRow == 0) {
        // 创建合并区域对象
        CellRangeAddress cellRangeAddress = new CellRangeAddress(
            context.getRowIndex(),                  // 起始行
            context.getRowIndex() + eachRow - 1,    // 结束行
            columnIndex,                            // 起始列
            columnIndex + columnExtend - 1);        // 结束列
            
        // 执行合并（unsafe方法避免校验提升性能）
        context.getWriteSheetHolder().getSheet().addMergedRegionUnsafe(cellRangeAddress);
    }
}

6.2 与OnceAbsoluteMergeStrategy对比

mermaid

7. 总结与最佳实践

7.1 策略选择指南

合并类型	推荐策略	适用场景
规则性重复合并	LoopMergeStrategy	数据列表、分类汇总
固定区域合并	OnceAbsoluteMergeStrategy	报表标题、表头
动态数据合并	自定义策略	相同值合并、树形结构

7.2 企业级应用模板

// 生产环境通用配置
public class ExcelMergeConfig {
    // 订单报表合并策略
    public static LoopMergeStrategy orderReportMergeStrategy() {
        return new LoopMergeStrategy(3, 2, 1) {
            @Override
            public void afterRowDispose(RowWriteHandlerContext context) {
                // 添加权限控制
                if (SecurityUtils.hasRole("ADMIN")) {
                    super.afterRowDispose(context);
                }
            }
        };
    }
    
    // 通用合并工具方法
    public static void applyMerges(ExcelWriter writer, MergeType type) {
        switch (type) {
            case ORDER:
                writer.registerWriteHandler(orderReportMergeStrategy());
                break;
            case INVENTORY:
                writer.registerWriteHandler(new LoopMergeStrategy(5, 1, 0));
                break;
            // 其他合并类型...
        }
    }
}

7.3 未来展望

EasyExcel团队计划在2.4.x版本中推出：

基于内容的智能合并功能
合并单元格的数据验证支持
跨Sheet页合并能力

持续关注官方仓库获取更新：https://gitcode.com/gh_mirrors/ea/easyexcel

8. 思考题与实践作业

如何实现"合并单元格且内容居中"的效果？
尝试解决合并后筛选功能失效的问题
设计一个支持树形结构数据的合并策略

欢迎在评论区分享你的解决方案，点赞收藏获取更多Excel处理技巧！

【免费下载链接】easyexcel 快速、简洁、解决大文件内存溢出的java处理Excel工具项目地址: https://gitcode.com/gh_mirrors/ea/easyexcel

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考