1. EasyExcel 2.2.10版本样式处理实战指南
最近在做一个报表导出功能时，发现很多开发者对EasyExcel的样式处理存在理解误区。特别是当需要针对特定行设置特殊样式时，往往陷入反复调试的困境。本文将基于2.2.10版本，分享如何精准控制本地文件的行级样式。
注意：本文所有代码示例基于Java 8和EasyExcel 2.2.10版本验证通过，建议使用相同环境进行测试。
1.1 为什么需要行级样式控制
在财务对账单、学生成绩单等场景中，我们经常需要：
- 将合计行设置为加粗黄色背景
- 将异常数据行标记为红色字体
- 给表头行添加特殊边框样式
传统做法是创建多个实体类分别设置样式，但这样会导致代码臃肿。EasyExcel 2.2.10提供了更优雅的解决方案。
2. 核心API解析与样式策略设计
2.1 关键类说明
java复制// 核心处理器
public class CustomCellWriteHandler implements CellWriteHandler {
// 在单元格创建后触发
@Override
public void afterCellCreate(WriteSheetHolder writeSheetHolder,
WriteTableHolder writeTableHolder, Cell cell,
Head head, Integer relativeRowIndex, Boolean isHead) {
// 样式处理逻辑
}
}
// 样式构建工具
CellStyle buildStyle(WriteWorkbookHolder writeWorkbookHolder) {
Workbook workbook = writeWorkbookHolder.getWorkbook();
CellStyle cellStyle = workbook.createCellStyle();
// 设置边框、背景等样式
return cellStyle;
}
2.2 样式策略设计模式
推荐采用策略模式管理不同行的样式规则：
java复制public interface StyleStrategy {
boolean match(int rowIndex, Object data);
CellStyle getCellStyle(WriteWorkbookHolder holder);
}
// 示例：标红负数策略
public class NegativeRedStrategy implements StyleStrategy {
@Override
public boolean match(int rowIndex, Object data) {
if(data instanceof AccountDetail) {
return ((AccountDetail)data).getAmount() < 0;
}
return false;
}
@Override
public CellStyle getCellStyle(WriteWorkbookHolder holder) {
CellStyle style = holder.getWorkbook().createCellStyle();
Font font = holder.getWorkbook().createFont();
font.setColor(Font.COLOR_RED);
style.setFont(font);
return style;
}
}
3. 完整实现流程
3.1 基础环境搭建
xml复制<!-- pom.xml依赖 -->
<dependency>
<groupId>com.alibaba</groupId>
<artifactId>easyexcel</artifactId>
<version>2.2.10</version>
</dependency>
3.2 分步骤实现
步骤1：创建自定义WriteHandler
java复制public class DynamicStyleHandler extends AbstractRowWriteHandler {
private List<StyleStrategy> strategies;
public DynamicStyleHandler(List<StyleStrategy> strategies) {
this.strategies = strategies;
}
@Override
public void afterRowDispose(WriteSheetHolder writeSheetHolder,
WriteTableHolder writeTableHolder, Row row,
Object data, Integer relativeRowIndex, Boolean isHead) {
for(StyleStrategy strategy : strategies) {
if(strategy.match(row.getRowNum(), data)) {
applyStyle(row, strategy, writeSheetHolder);
}
}
}
private void applyStyle(Row row, StyleStrategy strategy,
WriteSheetHolder holder) {
CellStyle style = strategy.getCellStyle(holder.getWorkbookHolder());
for(int i=0; i<row.getLastCellNum(); i++) {
Cell cell = row.getCell(i);
if(cell != null) {
cell.setCellStyle(style);
}
}
}
}
步骤2：构建ExcelWriter
java复制List<StyleStrategy> strategies = Arrays.asList(
new HeaderStyleStrategy(),
new NegativeRedStrategy(),
new SummaryStyleStrategy()
);
EasyExcel.write("output.xlsx", DataModel.class)
.registerWriteHandler(new DynamicStyleHandler(strategies))
.sheet("Sheet1")
.doWrite(dataList);
3.3 复杂样式示例
合并单元格+渐变背景色实现：
java复制public class MergedRegionStyle implements StyleStrategy {
@Override
public CellStyle getCellStyle(WriteWorkbookHolder holder) {
CellStyle style = holder.getWorkbook().createCellStyle();
style.setFillForegroundColor(IndexedColors.SKY_BLUE.getIndex());
style.setFillPattern(FillPatternType.SOLID_FOREGROUND);
// 设置渐变背景（仅支持.xlsx格式）
if(holder.getWorkbook() instanceof XSSFWorkbook) {
XSSFCellStyle xssfStyle = (XSSFCellStyle)style;
XSSFColor color1 = new XSSFColor(new java.awt.Color(204, 204, 255), null);
XSSFColor color2 = new XSSFColor(new java.awt.Color(153, 153, 255), null);
xssfStyle.setFillForegroundColor(color1);
xssfStyle.setFillBackgroundColor(color2);
xssfStyle.setFillPattern(FillPatternType.GRADIENT);
}
return style;
}
}
4. 性能优化与常见问题
4.1 样式缓存机制
频繁创建CellStyle会导致内存溢出：
java复制// 正确的样式缓存实现
public class StyleCache {
private Map<String, CellStyle> cache = new ConcurrentHashMap<>();
public CellStyle getStyle(WriteWorkbookHolder holder, String styleKey,
Function<WriteWorkbookHolder, CellStyle> builder) {
return cache.computeIfAbsent(styleKey, k -> builder.apply(holder));
}
}
// 使用示例
styleCache.getStyle(holder, "red-bold", h -> {
CellStyle style = h.getWorkbook().createCellStyle();
Font font = h.getWorkbook().createFont();
font.setBold(true);
font.setColor(Font.COLOR_RED);
style.setFont(font);
return style;
});
4.2 典型问题排查
问题1：样式不生效
- 检查WriteHandler注册顺序
- 确认rowIndex是否正确（从0开始计数）
- 调试match()方法是否返回true
问题2：文件损坏
- 确保没有跨线程操作Workbook
- 检查是否重复关闭流
- 验证Excel格式兼容性（.xls与.xlsx差异）
问题3：性能瓶颈
- 使用StyleCache减少样式创建
- 批量处理数据避免单行操作
- 考虑使用模板方式预定义样式
5. 高级应用场景
5.1 条件格式扩展
实现类似Excel的条件格式规则：
java复制public class DataBarFormatStrategy implements StyleStrategy {
@Override
public CellStyle getCellStyle(WriteWorkbookHolder holder) {
if(holder.getWorkbook() instanceof XSSFWorkbook) {
XSSFCellStyle style = (XSSFCellStyle)holder.getWorkbook().createCellStyle();
XSSFDataBarFormattingRule rule = new XSSFDataBarFormattingRule(
new XSSFColor(new java.awt.Color(124, 252, 0), null),
new XSSFColor(new java.awt.Color(0, 100, 0), null));
style.setDataBarFormattingRule(rule);
return style;
}
return null;
}
}
5.2 动态列样式
结合列索引实现列级控制：
java复制public class ColumnStyleStrategy implements StyleStrategy {
private int columnIndex;
public ColumnStyleStrategy(int columnIndex) {
this.columnIndex = columnIndex;
}
@Override
public boolean match(int rowIndex, Object data) {
return true; // 所有行都应用
}
@Override
public void applyStyle(Row row, WriteSheetHolder holder) {
Cell cell = row.getCell(columnIndex);
if(cell != null) {
cell.setCellStyle(createStyle(holder));
}
}
}
在实际项目中，我发现样式处理最容易被忽视的是性能问题。特别是在导出大数据量时，建议：
- 优先使用模板预定义样式
- 对相同样式使用缓存
- 避免在循环中创建Font对象
- 考虑使用SXSSF模式处理百万级数据