SpringBoot项目导出Excel太丑用EasyExcel自定义复杂表头和样式带合并单元格和备注当你需要向业务方或领导提交数据报表时一个专业、美观的Excel文件往往能大幅提升沟通效率。很多开发者在使用SpringBoot导出Excel时常常遇到格式混乱、样式单一的问题导致导出的文件看起来很业余。本文将带你深入掌握EasyExcel的高级功能实现多级表头、合并单元格、自定义样式等专业报表效果。1. 为什么需要美化Excel报表在日常开发中我们经常需要将数据库中的数据导出为Excel文件。基础的导出功能虽然简单易用但往往存在以下问题表头单一缺乏多级分类单元格样式单调无法突出重点数据缺少必要的说明和备注布局混乱可读性差这些问题会导致业务人员阅读困难甚至影响数据决策的质量。通过EasyExcel的WriteHandler机制我们可以轻松解决这些问题生成专业级的业务报表。2. EasyExcel高级功能概览EasyExcel提供了丰富的API来定制Excel输出主要包括以下核心功能2.1 表头定制ExcelProperty(value {主分类, 子分类, 字段名}, order 1) private String fieldName;通过数组形式的value属性可以轻松创建多级表头。2.2 样式控制HeadStyle(fillPatternType FillPatternType.SOLID_FOREGROUND, fillForegroundColor 10) HeadFontStyle(fontHeightInPoints 12, color 1) ContentStyle(horizontalAlignment HorizontalAlignment.CENTER) private String importantField;使用注解可以快速定义表头和内容的样式。2.3 合并单元格sheet.addMergedRegion(new CellRangeAddress(firstRow, lastRow, firstCol, lastCol));通过CellRangeAddress可以实现任意区域的单元格合并。3. 实现专业报表的完整方案3.1 多级表头实现多级表头能让数据分类更清晰。下面是一个完整示例Data public class ReportVO { ExcelProperty(value {学生信息, 基本信息, 姓名}, order 1) private String name; ExcelProperty(value {学生信息, 基本信息, 性别}, order 2) private String gender; ExcelProperty(value {学生信息, 学籍信息, 学号}, order 3) private String studentId; ExcelProperty(value {成绩信息, 语文}, order 4) private Integer chineseScore; ExcelProperty(value {成绩信息, 数学}, order 5) private Integer mathScore; }3.2 自定义样式处理器通过实现WriteHandler接口可以完全控制Excel的生成过程public class CustomStyleHandler implements SheetWriteHandler { Override public void afterSheetCreate(WriteWorkbookHolder writeWorkbookHolder, WriteSheetHolder writeSheetHolder) { Workbook workbook writeWorkbookHolder.getWorkbook(); Sheet sheet writeSheetHolder.getSheet(); // 设置标题行样式 CellStyle titleStyle workbook.createCellStyle(); titleStyle.setFillForegroundColor(IndexedColors.SKY_BLUE.getIndex()); titleStyle.setFillPattern(FillPatternType.SOLID_FOREGROUND); titleStyle.setAlignment(HorizontalAlignment.CENTER); // 添加报表标题 Row titleRow sheet.createRow(0); titleRow.setHeightInPoints(30); Cell titleCell titleRow.createCell(0); titleCell.setCellValue(2023年度学生成绩报表); titleCell.setCellStyle(titleStyle); sheet.addMergedRegion(new CellRangeAddress(0, 0, 0, 5)); // 设置表头样式 CellStyle headerStyle workbook.createCellStyle(); Font headerFont workbook.createFont(); headerFont.setBold(true); headerFont.setColor(IndexedColors.WHITE.getIndex()); headerStyle.setFont(headerFont); headerStyle.setFillForegroundColor(IndexedColors.BLUE_GREY.getIndex()); headerStyle.setFillPattern(FillPatternType.SOLID_FOREGROUND); // 应用表头样式 Row headerRow sheet.getRow(1); for (Cell cell : headerRow) { cell.setCellStyle(headerStyle); } } }3.3 添加备注和说明专业的报表通常需要包含说明文字public void addRemarks(Sheet sheet) { // 添加备注行 Row remarkRow sheet.createRow(sheet.getLastRowNum() 2); remarkRow.setHeightInPoints(20); Cell remarkCell remarkRow.createCell(0); remarkCell.setCellValue(备注本报表数据截止至2023年12月31日); // 设置备注样式 CellStyle remarkStyle sheet.getWorkbook().createCellStyle(); Font remarkFont sheet.getWorkbook().createFont(); remarkFont.setItalic(true); remarkFont.setColor(IndexedColors.GREY_50_PERCENT.getIndex()); remarkStyle.setFont(remarkFont); remarkCell.setCellStyle(remarkStyle); sheet.addMergedRegion(new CellRangeAddress(remarkRow.getRowNum(), remarkRow.getRowNum(), 0, 5)); }4. 完整导出流程示例下面是一个完整的导出控制器实现RestController RequestMapping(/report) public class ReportController { GetMapping(/export) public void exportReport(HttpServletResponse response) throws IOException { // 1. 准备数据 ListReportVO data reportService.getReportData(); // 2. 设置响应头 response.setContentType(application/vnd.ms-excel); response.setCharacterEncoding(utf-8); String fileName URLEncoder.encode(学生成绩报表, UTF-8); response.setHeader(Content-disposition, attachment;filename fileName .xlsx); // 3. 执行导出 EasyExcel.write(response.getOutputStream(), ReportVO.class) .registerWriteHandler(new CustomStyleHandler()) .registerWriteHandler(new CustomCellStyleHandler()) .sheet(学生成绩) .doWrite(data); } }5. 高级技巧与最佳实践5.1 条件格式化根据数据值动态设置样式public class ConditionalStyleHandler extends AbstractRowWriteHandler { Override public void afterRowDispose(WriteSheetHolder writeSheetHolder, WriteTableHolder writeTableHolder, Row row, Integer relativeRowIndex, Boolean isHead) { if (isHead) return; // 成绩低于60分标红 Cell scoreCell row.getCell(3); // 假设第4列是成绩 if (scoreCell ! null scoreCell.getCellType() CellType.NUMERIC) { double score scoreCell.getNumericCellValue(); if (score 60) { CellStyle style writeSheetHolder.getSheet().getWorkbook().createCellStyle(); style.setFillForegroundColor(IndexedColors.RED.getIndex()); style.setFillPattern(FillPatternType.SOLID_FOREGROUND); scoreCell.setCellStyle(style); } } } }5.2 大数据量优化当导出大量数据时需要注意内存使用// 分页查询并写入 try (ExcelWriter excelWriter EasyExcel.write(response.getOutputStream()).build()) { WriteSheet writeSheet EasyExcel.writerSheet(数据).head(DataVO.class).build(); int page 1; while (true) { PageDataVO dataPage dataService.getDataByPage(page, 1000); if (dataPage.getRecords().isEmpty()) break; excelWriter.write(dataPage.getRecords(), writeSheet); page; } }5.3 模板导出对于复杂报表可以先准备模板文件// 基于模板导出 String templateFileName template.xlsx; EasyExcel.write(response.getOutputStream()) .withTemplate(templateFileName) .sheet() .registerWriteHandler(new CustomStyleHandler()) .doWrite(data);6. 常见问题解决方案在实际项目中我们可能会遇到以下典型问题中文乱码问题确保响应头设置正确编码文件名使用URLEncoder.encode编码样式不生效检查WriteHandler的执行顺序确保没有其他处理器覆盖了你的样式性能问题对于大数据量使用分页查询避免在循环中频繁创建样式对象合并单元格错位注意合并区域的索引是从0开始确保合并区域不会与其他内容重叠7. 报表设计原则设计专业报表时应遵循以下原则清晰性表头层级不超过3级一致性相同类型数据使用相同样式重点突出关键数据使用不同颜色或字体完整性包含必要的标题、页码和备注适应性考虑打印时的页面布局在实际项目中我发现最实用的技巧是预先在Excel中设计好样式然后再通过代码实现相同的效果。这样既能保证报表美观又能提高开发效率。
`)
