1
2
3
4
5
6

<!-- fastExcel工具 -->
<dependency>
    <groupId>cn.idev.excel</groupId>
    <artifactId>fastexcel</artifactId>
    <version>1.2.0</version> <!-- Use the latest version -->
</dependency>

1
2

//表格格式设置为计算类型
cell.setCellFormula();

1
2

//这一步没有的话，导出的数据类型都是 String ，只有数值类型公式才会自动计算
cell.setCellValue(Integer.parseInt(cell.getStringCellValue()));

  1
  2
  3
  4
  5
  6
  7
  8
  9
 10
 11
 12
 13
 14
 15
 16
 17
 18
 19
 20
 21
 22
 23
 24
 25
 26
 27
 28
 29
 30
 31
 32
 33
 34
 35
 36
 37
 38
 39
 40
 41
 42
 43
 44
 45
 46
 47
 48
 49
 50
 51
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101

/**
 * 测试导出 excel
 * @author jamesaks
 * @since 2025/10/25
 */
@Slf4j
@SpringBootTest(classes = MaterialApplication.class)
public class TestExportExcelStyle {

    public void reportExport(ExcelTemplate template) {
        // 1. 检查数据
        template.checkIsEmpty();

        // 2. 文件路径
        String filePath = "/Users/jamesaks/Downloads/excel-test/" + System.currentTimeMillis() + ".xlsx";
        File file = new File(filePath);
        if (!file.getParentFile().exists()) {
            boolean mkdirSuccess = file.getParentFile().mkdirs();
            if (!mkdirSuccess) {
                throw new RuntimeException("创建目录失败");
            }
        }

        // 3. 写文件（注册样式）
        try (ExcelWriter writer = template.getWriterBuilder(EasyExcel.write(file)).build()) {
            WriteSheet sheet = EasyExcel.writerSheet(template.sheetName()).build();
            writer.writeContext().writeWorkbookHolder().getWorkbook().setForceFormulaRecalculation(true);

            // 写 head + rows：使用 Table 的 head 仅用于表头，实际我们写的是原始行数据
            WriteTable table = EasyExcel.writerTable(0).needHead(true).head(template.getHead()).build();
            writer.write(template.getBody(), sheet, table);
            
            //TODO 这里写不写都无所谓，不影响
            //Workbook workbook = writer.writeContext().writeWorkbookHolder().getCachedWorkbook();
            // 设置强制计算公式：不然公式会以字符串的形式显示在excel中
            //workbook.setForceFormulaRecalculation(true);
            // 新增：预计算所有公式，缓存结果值到 cell（解决显示 0 问题）
            //FormulaEvaluator formulaEvaluator = workbook.getCreationHelper().createFormulaEvaluator();
            // 计算整个 workbook 的公式，并设置 cached value
            //formulaEvaluator.evaluateAll();
        }
    }


    @Test
    void testExcel() {
        //测试excel带公式导出
        reportExport(getTemplate());
        log.info("生成成功");
    }

    private ExcelTemplate getTemplate() {
        return new ExcelTemplate() {

            @Override
            public String sheetName() {
                return "测试EXCEL";
            }

            @Override
            public List<List<ExcelCell>> rows() {
                return List.of(
                        List.of(new ExcelCell("2025-11-03"), new ExcelCell(1.0), new ExcelCell(2.0), new ExcelCell("=B2+C2")),
                        List.of(new ExcelCell("2025-11-04"), new ExcelCell(1.0), new ExcelCell(2.0), new ExcelCell("=SUM(B2,C2)")),
                        List.of(new ExcelCell("2025-11-05"), new ExcelCell(1.0), new ExcelCell(2.0), new ExcelCell("=IFERROR(B2 / 7 + C2,0)"))
                );
            }

            @Override
            public List<List<ExcelCell>> head() {
                return List.of(
                        List.of(new ExcelCell("时间")),
                        List.of(new ExcelCell("常量1")),
                        List.of(new ExcelCell("常量2")),
                        List.of(new ExcelCell("SUM"))
                );
            }

            @Override
            public ExcelWriterBuilder getWriterBuilder(ExcelWriterBuilder writerBuilder) {
                return writerBuilder.registerWriteHandler(new ExcelFormulaHandler());
            }

            private record ExcelFormulaHandler() implements CellWriteHandler {
                @Override
                public void afterCellDispose(WriteSheetHolder writeSheetHolder, WriteTableHolder writeTableHolder, List<WriteCellData<?>> cellDataList, Cell cell, Head head, Integer relativeRowIndex, Boolean isHead) {
                    if (!isHead && CellType.STRING.equals(cell.getCellType()) && cell.getStringCellValue().contains("=")) {
                        //设置计算类型，去除=
                        cell.setCellFormula(cell.getStringCellValue().substring(1));
                    }
                    
                    //筛选出数值类型的 cell
                    if (StrUtil.isNumeric(cell.getStringCellValue())) {
                        cell.setCellValue(Integer.parseInt(cell.getStringCellValue()));
                    }
                }
            }
        };
    }

}

  1
  2
  3
  4
  5
  6
  7
  8
  9
 10
 11
 12
 13
 14
 15
 16
 17
 18
 19
 20
 21
 22
 23
 24
 25
 26
 27
 28
 29
 30
 31
 32
 33
 34
 35
 36
 37
 38
 39
 40
 41
 42
 43
 44
 45
 46
 47
 48
 49
 50
 51
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161

/**
 * Excel 导出模板
 *
 * @author jamesaks
 * @since 2025/10/9
 */
public interface ExcelTemplate {
    /**
     * 页名称
     */
    String sheetName();

    /**
     * 除了head之外的数据 rows 外层的 List 代表一行数据，里面的List 代表每行的每列数据
     */
    List<List<ExcelCell>> rows();

    /**
     * Excel 标题，外层的 List 表达每一列，里面的List 代表有多少行，决定头有几行是里面的 List 决定的
     */
    List<List<ExcelCell>> head();

    /**
     * 获取除标题外数据
     */
    default List<List<String>> getBody() {
        //有序合并
        return rows().stream()
                .map(list -> list.stream().map(ExcelCell::getValue).toList())
                .toList();
    }

    /**
     * 获取excel头
     */
    default List<List<String>> getHead() {
        //有序合并
        return head().stream()
                .map(list -> list.stream().map(ExcelCell::getValue).toList())
                .toList();
    }

    /**
     * excel 构建者，样式相关的可以在这设置，不是复杂样式使用excelStyle即可，不使用 easy excel 默认样式则需要重写这个
     */
    default ExcelWriterBuilder getWriterBuilder(ExcelWriterBuilder writerBuilder) {
        return writerBuilder.registerWriteHandler(getExcelStyle());
    }

    /**
     * 获取样式
     */
    default WriteHandler getExcelStyle() {
        if (excelStyle() != null) {
            return excelStyle();
        }
        return defaultStyle();
    }

    default void checkIsEmpty() {
        if (rows() == null || rows().isEmpty()) {
            throw new BusinessException(BusinessErrorCode.ERROR, "Excel列数据不存在");
        }

        if (head() == null || head().isEmpty()) {
            throw new BusinessException(BusinessErrorCode.ERROR, "Excel标题数据不存在");
        }
    }

    /**
     * 子类选择是否重写，不重写使用默认的样式
     */
    default WriteHandler excelStyle() {
        return null;
    }

    /**
     * 默认样式
     */
    private WriteHandler defaultStyle() {
        //创建 EasyExcel 写样式（头/内容：不换行，字体 12，居中）
        WriteCellStyle headStyle = new WriteCellStyle();
        WriteFont headFont = new WriteFont();
        headFont.setFontHeightInPoints((short) 12);
        headStyle.setWriteFont(headFont);
        headStyle.setWrapped(false);
        headStyle.setHorizontalAlignment(HorizontalAlignment.CENTER);
        headStyle.setVerticalAlignment(VerticalAlignment.CENTER);

        WriteCellStyle contentStyle = new WriteCellStyle();
        WriteFont contentFont = new WriteFont();
        contentFont.setFontHeightInPoints((short) 12);
        contentStyle.setWriteFont(contentFont);
        // 关键：不自动换行
        contentStyle.setWrapped(false);
        contentStyle.setHorizontalAlignment(HorizontalAlignment.CENTER);
        contentStyle.setVerticalAlignment(VerticalAlignment.CENTER);
        return new HorizontalCellStyleStrategy(headStyle, contentStyle);
    }

    /**
     * Excel 每一格
     */
    @Builder
    @NoArgsConstructor
    @AllArgsConstructor
    @Data
    class ExcelCell {

        private static final String EMPTY = "";

        /**
         *  一格的数据，为多个表示这一格有多行
         */
        private final List<Object> cellValues;

        private final boolean useSafeConvert = true;

        public ExcelCell(Object... values) {
            if (values.length == 0) {
                throw new BusinessException(BusinessErrorCode.ERROR, "Excel列数据不能为空");
            }
            this.cellValues = Arrays.stream(values).toList();
        }

        /**
         * 转为字符串
         * 目前只考虑一格只有一行的情况
         */
        public String getValue() {
            //转为字符串
            return cellValues.stream().map(this::safeConvertString).findFirst().orElse(EMPTY);
        }

        public String safeConvertString(Object s) {
            if (!useSafeConvert) {
                return Objects.toString(s);
            }

            if (s == null) {
                return EMPTY;
            }

            // 0 转为 "0"
            if (s instanceof Number num && num.intValue() == 0) {
                return "0";
            }

            //double去掉小数点
            if (s instanceof Double d && d.intValue() == d) {
                return String.valueOf(d.intValue());
            }

            // 把你的 NULL_STR 文本变为空
            if ("null".equals(s)) {
                return EMPTY;
            }
            return s.toString();
        }
    }
}