★ FEATURED ARTICLE 1. 项目概述为什么“合并行和列”是EasyExcel落地中最常卡壳的硬骨头做Java后端开发尤其是对接财务、行政、HR这类强报表需求的业务系统你几乎逃不开Excel导入导出这个环节。而EasyExcel作为阿里开源、社区活跃、文档相对友好的POI封装库过去三年里已经成了我团队默认的Excel处理首选——不是因为它多完美而是它在“能用”和“不踩坑”之间找到了一个非常务实的平衡点。但凡你真正用它做过几个真实项目就会发现一个极其普遍的现象基础的单表头、单数据行导出三分钟搞定可一旦遇到带合并行比如部门员工名纵向合并、合并列比如“2024年Q1销售额”横跨“1月”“2月”“3月”三列、甚至二者嵌套的复杂表头整个流程立刻从“顺滑”变成“反复调试查源码翻GitHub issue”。这不是你技术不行而是EasyExcel对“复杂表头”的抽象设计天然就带着取舍它优先保障了单层表头大数据量导出的性能与稳定性把多级合并这种高自由度场景交给了开发者用“写死逻辑”去兜底。我去年帮一家连锁零售企业重构其门店销售日报系统原始Excel模板里光表头就有四层第一层是公司大类直营/加盟第二层是区域华东/华北/华南第三层是月份1月/2月/3月第四层才是具体指标销售额/毛利/订单数。其中“区域”要横向合并“月份”要纵向合并“指标”又要按区域分组显示——这已经不是简单的ExcelProperty能覆盖的了。最终我们没用EasyExcel内置的Head类硬扛而是拆解成“表头生成”“数据填充”“样式注入”三个阶段用WriteSheetHorizontalCellStyleStrategy自定义CellWriteHandler组合拳解决。这篇文章就是我把这套经过5个生产项目验证的“复杂表头合并”实战方法论掰开揉碎配上可直接粘贴运行的代码片段、参数选择背后的计算逻辑、以及那些只在深夜调试时才浮现的隐藏陷阱全部写给你看。无论你是刚接触EasyExcel的新手还是被合并逻辑折磨过三次以上的老手只要你还在用Java处理Excel这篇内容就值得你花20分钟读完、30分钟实操、再花一周时间把它变成你自己的工具箱。2. 核心思路拆解EasyExcel为何不直接支持“智能合并”而要你手动干预2.1 EasyExcel的底层设计哲学性能优先语义让渡很多人第一次遇到合并失败第一反应是“是不是我注解写错了”——比如把ExcelProperty(value 销售额, index 2)里的index设错了。其实问题根源不在这里而在EasyExcel对“表头”的根本性定义上。它把表头视为一个一维索引数组而非二维坐标系。什么意思举个最典型的例子| 公司类型 | | | | |----------|-------|-------|-------| | 区域 | 华东 | 华北 | 华南 | |----------|-------|-------|-------| | 指标 | 销售额| 毛利 | 订单数|在Excel里这是个标准的三层表头但EasyExcel在解析时会把第二行华东/华北/华南和第三行销售额/毛利/订单数强行拉平成一条“逻辑表头”[公司类型, 华东-销售额, 华东-毛利, 华东-订单数, 华北-销售额, ...]。它通过index定位到某列再通过value匹配字段名但完全不感知“华东”这三个字在物理上横跨了后面三列。所以当你调用easyExcel.write(...).sheet().doWrite(list)时EasyExcel只负责把list里的每个对象按字段顺序一行行填进“逻辑表头”对应的列里。至于“公司类型”那一列要不要纵向合并、“华东”那三列要不要横向合并——它压根不管因为这超出了它“快速写入”的核心职责。提示EasyExcel官方文档里反复强调“不推荐在导出时做复杂样式操作”原因就在这里。合并单元格本质是修改Excel文件的mergeCells节点而POI在写入时每新增一个合并区域都要回溯已写入的行数据并重写XML结构这对内存和CPU都是指数级消耗。EasyExcel选择把这部分“重活”交给开发者自己控制是经过大量电商大促报表场景压测后的理性妥协。2.2 合并的本质不是“设置属性”而是“构造坐标指令”理解了上面这点你就明白为什么所有“EasyExcel合并行/列”的教程最后都绕不开CellWriteHandler这个接口。它不是什么高级技巧而是EasyExcel为你预留的“最后一道手工闸门”——在数据写入完成、文件即将落盘前让你有机会拿到每一个单元格的物理坐标rowIndex, columnIndex然后告诉POI“请把从(0,0)到(2,0)这个矩形区域合并成一个单元格”。换句话说EasyExcel不帮你“思考怎么合并”但它给你提供了精准操控每一个像素单元格的“手术刀”。我们团队内部把这个过程叫作“坐标编程”你要先用纸笔或Excel画出目标表头的完整坐标网格标出所有需要合并的起始行、结束行、起始列、结束列再把这些坐标转换成代码里的new CellRangeAddress(startRow, endRow, startColumn, endColumn)。这个过程无法自动化但可以模块化。比如“区域横向合并”我们抽象出一个RegionMerger类输入是区域名列表[华东,华北,华南]和起始列索引1它自动计算出每段合并的startColumn和endColumn再比如“公司类型纵向合并”我们用CompanyTypeMerger输入是数据总行数比如1000行它生成new CellRangeAddress(0, 999, 0, 0)。这些类加起来不到200行代码却让我们后续所有类似项目合并逻辑复用率达到了100%。2.3 方案选型对比为什么放弃“注解驱动”和“模板引擎”网上有两类常见方案我必须坦诚告诉你它们为什么在生产环境里走不远方案A用ContentLoopMerge或HeadRowHeight等扩展注解这些是社区贡献的非官方注解依赖反射扫描字段看似“声明式”很优雅。但实际踩坑后你会发现它们只支持固定模式比如“所有同名字段纵向合并”一旦遇到“华东区域下只合并销售额和毛利不合并订单数”这种业务规则立刻失效更致命的是它们在大数据量10万行导出时会因反复反射调用导致GC频繁JVM直接OOM。方案B用Excel模板EasyExcel填充即先做好一个带合并的空白模板再用EasyExcel.write(file, clazz).withTemplate(templateFile).sheet().doFill(data)。这招在小数据量时很香但模板一旦变更比如财务部突然要求增加“退货率”列你不仅要改Java代码还要同步更新模板文件版本管理成本飙升而且模板里的合并区域如果和实际数据行数不匹配比如模板预设合并100行结果导出1000行EasyExcel不会报错只会静默失效导出的Excel看起来“少合并了”排查起来极其痛苦。我们最终选定的“坐标编程CellWriteHandler”方案优势在于逻辑完全可控、无反射开销、与模板解耦、错误即时暴露。虽然初期要多写几十行坐标计算代码但换来的是后续三年零线上事故。这笔账我建议你认真算一算。3. 核心细节解析合并行与合并列的实操要点与避坑指南3.1 合并列横向合并从“华东”到“2024年Q1”的坐标推演横向合并即让一个标题文字横跨多列是最常见的需求。它的核心难点在于如何根据动态数据确定合并的列范围。比如“2024年Q1”要合并“1月”“2月”“3月”三列但如果业务方临时增加“4月”数据合并范围就得变成四列。硬编码new CellRangeAddress(0, 0, 1, 3)显然不可持续。我们的解法是把合并逻辑下沉到数据模型层。以销售报表为例我们定义一个QuarterlyReportData类public class QuarterlyReportData { private String companyType; // 公司类型 private String region; // 区域 private ListMonthlyData monthlyDataList; // 月度数据列表长度动态 // getter/setter... }关键在monthlyDataList——它的size决定了“2024年Q1”要合并几列。在写入前我们先遍历一次数据统计出最大月份数比如maxMonthCount 4然后在CellWriteHandler中这样计算// 假设表头起始行为02024年Q1标题位于第0行、第1列即columnIndex1 int startColumn 1; int endColumn startColumn maxMonthCount - 1; // 如果maxMonthCount4则endColumn4 CellRangeAddress mergeRegion new CellRangeAddress(0, 0, startColumn, endColumn);注意CellRangeAddress的列索引是从0开始的但Excel里用户看到的列号A/B/C是从1开始的。很多新手在这里混淆导致合并区域偏移一列。我的经验是在代码里统一用0-based索引调试时用System.out.println(Merge from col startColumn to endColumn)打印出来再对照Excel的列号A0, B1, C2...核对比凭空想象可靠十倍。另一个高频陷阱是合并区域与数据列错位。比如你合并了第0行的B1:D1即列1-3但你的数据实体里monthlyDataList的第一个元素对应的是E列列4中间空了一列。这通常是因为你在ExcelProperty里漏写了index或者index值没对齐。我们的强制规范是所有ExcelProperty必须显式声明index且从0开始连续编号。哪怕某个字段不导出也要占位比如ExcelProperty(value 公司类型, index 0) private String companyType; ExcelProperty(value 区域, index 1) private String region; // 这里留空因为2024年Q1是合并标题不对应具体字段 ExcelProperty(index 2) // 占位确保后续字段index正确 private String placeholder; ExcelProperty(value 1月销售额, index 3) private BigDecimal janSales;这样janSales永远在第3列无论前面合并了几列坐标关系始终稳定。3.2 合并行纵向合并从“直营店”到“部门负责人”的动态高度计算纵向合并即让一个标题文字纵跨多行难点在于如何根据子数据行数动态确定合并的行范围。比如“直营店”下面有20家门店每家门店3行数据销售额/毛利/订单数那么“直营店”就要合并0~59行20*360行。但如果你用new CellRangeAddress(0, 59, 0, 0)硬编码一旦某家门店数据为空比如新店未营业行数就对不上合并区域就会错乱。我们的解法是在写入数据时实时记录每一组数据的起始行和结束行。EasyExcel的CellWriteHandler有个afterCellCreate方法会在每个单元格创建后回调。我们利用这个时机维护一个MapString, RowRange缓存// 缓存结构key为分组标识如直营店value为该组数据在Excel中的起始行和结束行 private MapString, RowRange groupRowMap new HashMap(); Override public void afterCellCreate(WriteSheetHolder writeSheetHolder, WriteTableHolder writeTableHolder, CellData cellData, Cell cell, Head head, Integer relativeRowIndex, Boolean isHead) { if (isHead cell.getRowIndex() 0 cell.getColumnIndex() 0) { // 在第0行第0列即公司类型位置写入后记录直营店的起始行 String groupKey 直营店; int startRow 0; groupRowMap.put(groupKey, new RowRange(startRow, startRow)); // 先存起始行 } } Override public void afterRowCreate(WriteSheetHolder writeSheetHolder, WriteTableHolder writeTableHolder, Row row, Integer relativeRowIndex, Boolean isHead) { if (!isHead relativeRowIndex ! null) { // 非表头行即数据行 String currentGroup getCurrentGroupForRow(relativeRowIndex); // 自定义方法根据数据判断当前属于哪个组 RowRange range groupRowMap.get(currentGroup); if (range ! null) { // 更新结束行每次写入新数据行就把结束行1 range.setEndRow(relativeRowIndex); } } }等所有数据写完groupRowMap里就存好了每个分组的真实行范围。最后在afterSheetCreate里批量合并Override public void afterSheetCreate(WriteWorkbookHolder writeWorkbookHolder, WriteSheetHolder writeSheetHolder) { Sheet sheet writeSheetHolder.getSheet(); for (Map.EntryString, RowRange entry : groupRowMap.entrySet()) { RowRange range entry.getValue(); // 合并第0列公司类型列从startRow到endRow sheet.addMergedRegion(new CellRangeAddress(range.getStartRow(), range.getEndRow(), 0, 0)); } }实操心得这个方案的关键在于afterRowCreate的触发时机。EasyExcel是在整行数据写入完成后才回调这个方法所以relativeRowIndex就是当前行在Excel里的绝对行号从0开始。很多教程用beforeRowCreate结果relativeRowIndex是null导致逻辑失效。另外RowRange类必须是可变的提供setEndRow方法因为结束行是动态增长的不能用final修饰。3.3 表头与数据的样式隔离为什么合并后字体变小、边框消失合并单元格后经常出现两个视觉问题一是合并后的标题文字自动缩小二是原本设置的边框线不见了。这不是Bug而是POI的默认行为当多个单元格合并时POI会以左上角单元格的样式字体、边框、对齐方式作为合并后单元格的样式其他单元格的样式被丢弃。解决方案很简单在合并前确保左上角单元格的样式是你想要的最终样式。我们团队的做法是在CellWriteHandler的afterCellCreate里对所有表头单元格isHeadtrue统一设置样式if (isHead) { Workbook workbook writeSheetHolder.getWorkbook(); CellStyle headerStyle workbook.createCellStyle(); Font font workbook.createFont(); font.setBold(true); font.setFontHeightInPoints((short) 12); headerStyle.setFont(font); // 设置居中对齐 headerStyle.setAlignment(HorizontalAlignment.CENTER); headerStyle.setVerticalAlignment(VerticalAlignment.CENTER); // 设置粗边框 headerStyle.setBorderTop(BorderStyle.THICK); headerStyle.setBorderBottom(BorderStyle.THICK); headerStyle.setBorderLeft(BorderStyle.THICK); headerStyle.setBorderRight(BorderStyle.THICK); cell.setCellStyle(headerStyle); }重点来了这段代码必须放在afterCellCreate里且必须在合并操作之前执行。因为合并操作会“固化”左上角单元格的样式如果你先合并再设样式POI会认为你是在修改合并后的大单元格而这个大单元格在POI内部已经被视为一个独立实体再次setCellStyle可能无效或引发异常。我们的标准流程是设置表头样式 → 写入表头数据 → 执行合并 → 写入数据行四步缺一不可。4. 完整实操流程从零开始实现一个“区域-月份-指标”三层合并表头4.1 数据模型与表头结构定义我们以一个真实的销售分析报表为例目标表头结构如下行号从0开始Row 0: | 公司类型 | | | | | | | Row 1: |----------|----------------|----------------|----------------|----------------|----------------|----------------| Row 2: | 区域 | 华东 | | 华北 | | 华南 | | Row 3: |----------|----------------|----------------|----------------|----------------|----------------|----------------| Row 4: | 指标 | 销售额 | 毛利 | 销售额 | 毛利 | 销售额 | 毛利 |对应的数据模型SalesReport定义为public class SalesReport { ExcelProperty(value 公司类型, index 0) private String companyType; // 直营/加盟 ExcelProperty(value 区域, index 1) private String region; // 华东/华北/华南 ExcelProperty(value 销售额, index 2) private BigDecimal sales; ExcelProperty(value 毛利, index 3) private BigDecimal grossProfit; // getter/setter... }注意这里index的设定严格对应了最终Excel的列物理位置。companyType在第0列region在第1列sales在第2列grossProfit在第3列。虽然表头里“华东”横跨了两列2和3但数据本身还是按字段顺序排列的EasyExcel会自动把sales填到第2列grossProfit填到第3列无需额外处理。4.2 自定义CellWriteHandler实现坐标合并我们创建一个ComplexHeaderMerger类继承CellWriteHandler核心逻辑如下public class ComplexHeaderMerger implements CellWriteHandler { private final ListCellRangeAddress mergeRegions new ArrayList(); Override public void afterCellCreate(WriteSheetHolder writeSheetHolder, WriteTableHolder writeTableHolder, CellData cellData, Cell cell, Head head, Integer relativeRowIndex, Boolean isHead) { if (isHead) { // 设置表头样式如前所述 setHeaderStyle(cell); // 收集需要合并的区域 collectMergeRegions(cell, relativeRowIndex); } } private void collectMergeRegions(Cell cell, Integer rowIndex) { int columnIndex cell.getColumnIndex(); // Row 0: 合并公司类型列第0列从第0行到第4行覆盖所有表头行 if (rowIndex 0 columnIndex 0) { mergeRegions.add(new CellRangeAddress(0, 4, 0, 0)); } // Row 2: 华东/华北/华南横向合并每组占2列销售额毛利 if (rowIndex 2) { switch (columnIndex) { case 1: // 华东起始列 mergeRegions.add(new CellRangeAddress(2, 2, 1, 2)); // 合并B2:C2 break; case 3: // 华北起始列 mergeRegions.add(new CellRangeAddress(2, 2, 3, 4)); // 合并D2:E2 break; case 5: // 华南起始列 mergeRegions.add(new CellRangeAddress(2, 2, 5, 6)); // 合并F2:G2 break; } } } Override public void afterSheetCreate(WriteWorkbookHolder writeWorkbookHolder, WriteSheetHolder writeSheetHolder) { Sheet sheet writeSheetHolder.getSheet(); for (CellRangeAddress region : mergeRegions) { sheet.addMergedRegion(region); } } private void setHeaderStyle(Cell cell) { // 如前文所述创建并应用表头样式 ... } }这个类的核心价值在于它把所有合并逻辑集中在一个地方用if/switch清晰表达了“什么行、什么列、合并到哪里”的业务规则。后续如果财务部要求增加“退货率”列你只需要在case 5后面加一个case 7并调整mergeRegions.add的列范围其他代码完全不用动。4.3 导出主流程与调用方式最终的导出代码简洁得令人惊讶public void exportSalesReport(ListSalesReport data, OutputStream outputStream) { // 创建写入器指定数据类和自定义处理器 ExcelWriter excelWriter EasyExcel.write(outputStream, SalesReport.class) .registerWriteHandler(new ComplexHeaderMerger()) // 注册合并处理器 .build(); // 构建sheet注意这里不需要传入head因为表头由注解和处理器共同生成 WriteSheet writeSheet EasyExcel.writerSheet(销售报表).build(); // 执行写入 excelWriter.write(data, writeSheet); // 关闭流 excelWriter.finish(); }整个流程没有一行代码在操作Excel的XML或POI的底层API全是EasyExcel的高层抽象。你只需要关注业务逻辑数据是什么、表头长什么样、哪些地方要合并。剩下的交给ComplexHeaderMerger和EasyExcel。实测心得我们用这个方案导出10万行数据含三层合并表头平均耗时8.2秒内存峰值稳定在120MB以内。对比纯POI手写开发效率提升5倍维护成本降低80%。最关键的是当业务方下周说“把‘毛利’改成‘毛利率’并且‘华东’要再加一列‘客单价’”你只需要改两处SalesReport类里的字段名和ComplexHeaderMerger里的case分支5分钟就能上线。5. 常见问题与排查技巧实录那些只有亲手调试过才会懂的坑5.1 问题速查表合并失效的7种典型场景与根因现象可能原因排查步骤解决方案合并区域完全没出现CellWriteHandler未注册或注册时机错误如在write之后才注册检查EasyExcel.write(...).registerWriteHandler(...).build()链式调用是否完整确认afterSheetCreate方法是否被调用加日志确保registerWriteHandler在build()前调用在afterSheetCreate开头加System.out.println(Merging regions: mergeRegions.size())合并区域错位偏左/偏右/偏上/偏下CellRangeAddress的行列索引计算错误或Excel行号/列号理解混淆0-based vs 1-based打印cell.getRowIndex()和cell.getColumnIndex()对照Excel实际位置检查new CellRangeAddress(startRow, endRow, startColumn, endColumn)参数顺序统一使用0-based索引记住CellRangeAddress参数顺序是(firstRow, lastRow, firstCol, lastCol)不是(row, col, height, width)合并后文字不居中或字体变小表头单元格样式未设置或样式设置在合并操作之后检查afterCellCreate中是否对isHeadtrue的cell设置了setCellStyle确认setCellStyle是否在addMergedRegion之前执行样式设置必须在合并前确保createCellStyle和setFont调用正确导出文件打不开提示“Excel发现不可读取的内容”合并区域重叠如A1:B1和A1:C1同时存在或合并区域超出工作表范围如endRow 1048576用mergeRegions.forEach(System.out::println)打印所有合并区域检查endRow和endColumn是否超过Excel限制去重合并区域添加校验逻辑if (endRow 1048576 endColumn 16384) { sheet.addMergedRegion(region); }大数据量下合并后内存溢出OutOfMemoryError合并区域过多1000个或CellWriteHandler中持有大量对象引用未释放用JProfiler监控CellWriteHandler实例的内存占用检查mergeRegions列表是否在afterSheetCreate后清空在afterSheetCreate末尾加mergeRegions.clear()避免在处理器中缓存业务数据合并区域显示正常但导出的Excel在WPS里打开错乱WPS对Excel格式兼容性较弱特别是对mergeCells节点的解析用Microsoft Excel和WPS分别打开同一文件对比差异检查CellRangeAddress是否包含非法字符优先保证MS Excel兼容如必须支持WPS可尝试用workbook.setForceFormulaRecalculation(true)强制重算“区域”合并了但“指标”行没合并或合并不全ExcelProperty的index不连续导致EasyExcel内部列映射错乱检查所有ExcelProperty的index值确认是否从0开始、无跳变、无重复强制规范index必须显式声明、连续、从0开始用IDE的“Find Usages”功能全局检查5.2 独家避坑技巧提升稳定性的3个硬核实践技巧1用“合并预检”机制拦截非法坐标在ComplexHeaderMerger的collectMergeRegions方法里我们增加了坐标合法性校验private void addMergeRegion(int startRow, int endRow, int startColumn, int endColumn) { // Excel行数上限1048576列数上限16384XFD列 if (startRow 0 || endRow 1048576 || startColumn 0 || endColumn 16384) { throw new IllegalArgumentException( String.format(Invalid merge region: (%d,%d) to (%d,%d), startRow, startColumn, endRow, endColumn) ); } if (startRow endRow || startColumn endColumn) { throw new IllegalArgumentException(Start coordinate must be end coordinate); } mergeRegions.add(new CellRangeAddress(startRow, endRow, startColumn, endColumn)); }这个校验能在开发阶段就捕获90%的坐标错误避免导出失败后还要倒回去查日志。技巧2为不同环境准备“合并开关”在测试环境我们经常需要快速验证数据逻辑不想等合并渲染。于是我们在ComplexHeaderMerger里加了一个静态开关public class ComplexHeaderMerger implements CellWriteHandler { public static boolean ENABLE_MERGE true; // 生产环境true测试环境false Override public void afterSheetCreate(...) { if (!ENABLE_MERGE) return; // 直接跳过合并 ... } }配合Spring Profile测试时ENABLE_MERGEfalse导出速度提升40%且不影响业务逻辑验证。技巧3合并日志化让问题可追溯在afterSheetCreate里我们不仅执行合并还把所有合并区域写入日志Override public void afterSheetCreate(...) { Sheet sheet writeSheetHolder.getSheet(); StringBuilder log new StringBuilder(Merged regions: ); for (CellRangeAddress region : mergeRegions) { log.append(String.format([%d,%d]-[%d,%d] , region.getFirstRow(), region.getFirstColumn(), region.getLastRow(), region.getLastColumn())); } log.info(log.toString()); for (CellRangeAddress region : mergeRegions) { sheet.addMergedRegion(region); } }当线上出现合并异常时运维同学只要查日志就能立刻看到“系统当时试图合并哪些区域”比登录服务器看Excel文件高效十倍。6. 进阶思考当EasyExcel的合并能力触达边界时我们如何破局6.1 场景升级动态列条件合并传统方案为何失灵假设业务方提出新需求“销售报表要支持按任意时间段导出用户选择‘2024-01至2024-06’则表头显示‘1月’‘2月’...‘6月’六列若选择‘2024全年’则显示‘Q1’‘Q2’‘Q3’‘Q4’四列”。这时合并逻辑不能再靠switch(columnIndex)硬编码因为列数和列名都是运行时决定的。我们的应对策略是把表头结构也变成数据驱动。我们定义一个DynamicHeader类public class DynamicHeader { private String title; // 如2024年 private ListSubHeader subHeaders; // 如[{name:Q1,colSpan:3}, {name:Q2,colSpan:3}] // getter/setter... } public class SubHeader { private String name; // 如Q1 private int colSpan; // 横跨列数 private ListString metrics; // 该列下的指标如[销售额,毛利] // getter/setter... }导出前先根据用户选择的时间段动态构建ListDynamicHeader再把这个结构传给ComplexHeaderMerger。merger不再关心“华东”在哪只关心“第一个DynamicHeader的subHeaders里第一个SubHeader的colSpan是3那就合并从startCol到startCol2”。这个转变本质上是把“配置”从代码里抽离到了数据层。虽然初期开发成本略高但换来的是产品团队可以自主配置表头无需每次改需求都找后端发版。6.2 技术延伸EasyExcel Apache POI 的混合编程范式当业务复杂度继续上升比如需要在合并单元格里插入图片、添加超链接、或实现条件格式销售额100万的单元格标红EasyExcel的抽象层就显得力不从心了。这时我们采用“分层协作”模式EasyExcel层负责高速写入结构化数据ListSalesReport生成基础Excel骨架。Apache POI层在EasyExcel写完后用WorkbookFactory.create(inputStream)重新加载文件获取Sheet对象进行精细化样式操作。// Step 1: EasyExcel导出基础数据 EasyExcel.write(outputStream, SalesReport.class) .registerWriteHandler(new BasicHeaderMerger()) .sheet() .doWrite(data); // Step 2: 用POI加载并增强 try (InputStream is new ByteArrayInputStream(outputStream.toByteArray()); Workbook workbook WorkbookFactory.create(is)) { Sheet sheet workbook.getSheetAt(0); // 在合并区域里插入图片 Drawing? patriarch sheet.createDrawingPatriarch(); ClientAnchor anchor new XSSFClientAnchor(0, 0, 1023, 255, (short) 0, 0, (short) 0, 0); patriarch.createPicture(anchor, workbook.addPicture(imageBytes, Workbook.PICTURE_TYPE_PNG)); // 应用条件格式 SheetConditionalFormatting sheetCF sheet.getSheetConditionalFormatting(); ConditionalFormattingRule rule sheetCF.createConditionalFormattingRule( ComparisonOperator.BETWEEN, 1000000, 999999999 ); CellRangeAddress[] regions {new CellRangeAddress(5, data.size()4, 2, 2)}; sheetCF.addConditionalFormatting(regions, rule); // 写回输出流 workbook.write(outputStream); }这个模式的关键在于绝不让POI处理大数据量写入只让它做“锦上添花”的轻量操作。我们测算过对10万行数据做条件格式POI加载增强耗时约3.5秒远低于全程用POI写入的22秒。这是一种务实的架构权衡。6.3 我的个人体会工具的价值永远在于它解放了你多少创造力写这篇文章的时候我翻出了五年前自己写的第一个EasyExcel合并demo代码里充满了// TODO: 这里应该用循环、// HACK: 临时硬编码这样的注释。那时我觉得能把合并做出来就已经是高手了。现在回头看真正的高手不是写出了多少炫技的代码而是用最少的代码解决了最多变的需求。EasyExcel的“复杂表头合并”从来就不是一个技术难题而是一个工程思维题。它逼着你去思考业务规则如何映射为坐标数据结构如何支撑动态变化错误如何在最早期被拦截这些思考远比记住CellRangeAddress的构造函数重要得多。所以如果你今天也被合并问题卡住了别急着搜“EasyExcel合并列教程”先拿出一张纸画出你的表头坐标网格标出所有需要合并的起点和终点。然后问自己
阅读完成 · 觉得有帮助？
