1. 为什么需要智能行合并功能在日常开发中我们经常遇到这样的场景导出的Excel报表包含大量重复数据行比如同一个订单下的多个商品明细。传统导出方式会让每个商品都重复显示订单信息导致报表臃肿难读。我曾经接手过一个电商后台系统运营人员每天要手动合并上百份报表的重复行既浪费时间又容易出错。若依框架自带的Excel导出功能虽然强大但原生不支持自动合并行。这就好比给你一辆没有自动挡的汽车——能开但开起来特别累。通过扩展注解配置实现智能行合并后系统能自动识别相同值的相邻行就像Excel的合并居中功能但完全由代码控制。这个功能特别适合订单明细报表按订单号合并客户交易记录按客户ID合并库存流水台账按商品编码合并2. 核心实现原理拆解2.1 注解驱动设计关键是在Excel注解中新增mergeLine参数。这个设计灵感来自Spring的注解驱动开发模式用配置代替硬编码。比如定义订单实体时public class OrderVO { Excel(name 订单号, mergeLine 0,7,8) private String orderNo; Excel(name 商品名称) private String productName; }这里的mergeLine值0,7,8表示第0列订单号作为主合并列第7、8列需要跟随主列合并 相当于告诉程序当订单号相同时把第7、8列也合并起来2.2 合并算法实现在ExcelUtilMerge类的addCell方法中我设计了三步合并策略值比对当前行值与前一行对比if (value.equals(value_previous)) { // 记录合并起始行 if (this.mergeLine_start 0) { this.mergeLine_start thisLine - 1; } this.mergeLine_end thisLine; }范围判定当值不相等时检查是否有待合并区间if (this.mergeLine_start ! this.mergeLine_end) { // 执行合并操作 CellRangeAddress region new CellRangeAddress( this.mergeLine_start, this.mergeLine_end, column, column); sheet.addMergedRegion(region); }重置状态完成合并后清理标记this.mergeLine_start 0; this.mergeLine_end 0;这种算法的时间复杂度是O(n)对万级数据量依然高效。实测导出5000行数据仅比普通导出多耗时15%左右。3. 完整实现步骤3.1 环境准备确保你的项目包含若依框架4.0我用的是ruoyi-common 4.0.0Apache POI 5.0注意版本兼容性JDK8Lambda表达式会用到3.2 注解改造在Excel注解类中添加新属性public interface Excel { // ...原有属性... /** * 合并行配置格式主列,待合并列1,待合并列2 */ String mergeLine() default ; }3.3 工具类增强创建ExcelUtilMerge.java继承原有工具类重点改造三个地方新增合并状态跟踪字段private int mergeLine_start 0; private int mergeLine_end 0;改造单元格添加逻辑在addCell方法中加入前面提到的合并算法样式优化合并后的单元格需要特殊样式处理CellStyle mergedStyle wb.createCellStyle(); mergedStyle.setAlignment(HorizontalAlignment.CENTER); mergedStyle.setVerticalAlignment(VerticalAlignment.CENTER);3.4 业务层使用示例Controller层无需修改保持原有调用方式GetMapping(/export) public void export(HttpServletResponse response) { ListOrderVO list orderService.list(); ExcelUtilMergeOrderVO util new ExcelUtilMerge(OrderVO.class); util.exportExcel(list, 订单报表); }实体类配置示例public class OrderVO { Excel(name 订单号, mergeLine 0,1,3) private String orderNo; Excel(name 客户ID, mergeLine 2) private String customerId; Excel(name 商品名称) private String productName; }4. 避坑指南4.1 常见问题排查合并失效检查点确认POI版本无冲突检查注解值是否从0开始计数验证数据是否按主合并列排序性能优化建议大数据量导出时启用SXSSF模式this.wb new SXSSFWorkbook(500); // 内存中保留500行合并列不宜超过5个样式错乱处理合并前统一设置单元格样式避免在合并区域使用边框特效4.2 高级技巧多级合并实现通过注解值定义层级关系比如0;1,2表示先按第0列合并再按第1列合并动态合并策略重写needMerge方法实现自定义规则protected boolean needMerge(Object current, Object previous) { // 自定义合并条件 return StringUtils.equals(current, previous); }合并回调添加合并事件监听器处理特殊逻辑public interface MergeListener { void onMerge(Sheet sheet, CellRangeAddress region); }5. 效果对比与扩展原始导出效果| 订单号 | 商品名称 | | A001 | 手机 | | A001 | 耳机 | | A002 | 笔记本 |智能合并后| 订单号 | 商品名称 | | A001 | 手机 | | | 耳机 | | A002 | 笔记本 |扩展应用场景财务报表的科目合并学生成绩单的班级合并物流单据的批次合并这个方案在多个项目中经过验证包括电商ERP系统和物流管理系统。有个实际案例某客户原本需要2小时手动处理的日报表现在10秒就能生成专业格式。
