EasyExcel 3.1.1版本实现千分位格式导出的解决方案

在实际业务开发中，财务数据报表导出时经常需要展示千分位格式的数字。本文将详细介绍如何在使用EasyExcel 3.1.1版本时，实现BigDecimal类型字段的千分位格式化导出。

问题背景

在EasyExcel 3.1.1版本中，开发者尝试使用@NumberFormat("#,###.00")或@DateTimeFormat("#,##0.00")注解对BigDecimal类型字段进行格式化时，发现导出的Excel文件并未显示预期的千分位效果。

解决方案分析

经过实践验证，在EasyExcel 3.1.1版本中直接使用格式化注解可能无法达到预期效果。以下是两种可行的解决方案：

方案一：升级EasyExcel版本

建议将EasyExcel升级到3.3.4及以上版本。新版本对数字格式化支持更加完善，能够正确处理BigDecimal类型的千分位格式化需求。

方案二：自定义CellWriteHandler（推荐）

对于必须使用3.1.1版本的项目，可以通过自定义CellWriteHandler来实现千分位格式化。这种方法的核心思路是：

1. 继承LongestMatchColumnWidthStyleStrategy类
2. 重写样式处理方法
3. 为特定列设置千分位格式

实现代码示例

public class ThousandthsFormatHandler extends LongestMatchColumnWidthStyleStrategy {
    
    private final Map<Integer, Integer> cellStyleMap;
    
    public ThousandthsFormatHandler(Map<Integer, Integer> cellStyleMap) {
        this.cellStyleMap = cellStyleMap;
    }
    
    @Override
    protected CellStyle setContentCellStyle(WriteSheetHolder writeSheetHolder, Cell cell, Head head, Integer relativeRowIndex, Boolean isHead) {
        CellStyle thousandthsCellStyle = writeSheetHolder.getSheet().getWorkbook().createCellStyle();
        Integer num;
        
        if ((num = cellStyleMap.get(cell.getColumnIndex())) != null) {
            DataFormat format = writeSheetHolder.getSheet().getWorkbook().createDataFormat();
            short dataFormat = format.getFormat(BuiltinFormats.getBuiltinFormat(num));
            thousandthsCellStyle.setDataFormat(dataFormat);
            return thousandthsCellStyle;
        }
        
        return super.setContentCellStyle(writeSheetHolder, cell, head, relativeRowIndex, isHead);
    }
}

使用方式

1. 创建格式映射表：指定需要格式化的列索引和对应的格式代码
2. 在写入Excel时注册自定义处理器

Map<Integer, Integer> formatMap = new HashMap<>();
formatMap.put(2, 4); // 第3列使用千分位格式(格式代码4代表"#,##0.00")

EasyExcel.write(fileName, DemoData.class)
    .registerWriteHandler(new ThousandthsFormatHandler(formatMap))
    .sheet("Sheet1")
    .doWrite(dataList);

格式代码说明

Excel内置了多种数字格式，常用的千分位格式代码包括：

• 3: "#,##0"
• 4: "#,##0.00"
• 5: "¥#,##0;¥-#,##0"（带货币符号）

开发者可以根据实际需求选择合适的格式代码。

总结

虽然EasyExcel 3.1.1版本在直接使用注解格式化BigDecimal类型时存在局限性，但通过自定义CellWriteHandler的方式可以灵活实现各种复杂的数字格式化需求。这种方法不仅适用于千分位格式化，还可以扩展用于其他特殊格式需求，具有很好的通用性和灵活性。

对于新项目，建议直接使用EasyExcel 3.3.4及以上版本，以获得更好的格式化支持；对于已有项目，自定义处理器方案则提供了平滑的升级过渡方案。