快捷導(dǎo)航

EasyExcel如何導(dǎo)出多級且動(dòng)態(tài)的表頭

更新時(shí)間：2026年01月14日 09:15:57 作者：小憨憨的牛

文章介紹了使用EasyExcel庫實(shí)現(xiàn)Excel多級表頭導(dǎo)出的步驟,包括創(chuàng)建表頭集合、導(dǎo)出數(shù)據(jù)集合、設(shè)置樣式和列寬,以及自動(dòng)合并表頭和測試導(dǎo)出

實(shí)現(xiàn)步驟

創(chuàng)建表頭集合List<List<String>> headList，為每個(gè)單元格設(shè)置完整的表頭路徑（一級，二級....）
創(chuàng)建導(dǎo)出數(shù)據(jù)集合List<List<String>> dataList，每行列數(shù)要與最末及表頭的列數(shù)一致
定義表頭或單元格的樣式，列寬等
導(dǎo)出時(shí)應(yīng)用樣式

分析

EasyExcel 會(huì)根據(jù)你的Head結(jié)構(gòu)自動(dòng)判斷是否需要合并表頭。如果你的表頭是多層級的（比如有分組表頭），EasyExcel 會(huì)自動(dòng)合并相同的一級表頭。

動(dòng)態(tài)表頭可以根據(jù)實(shí)際的業(yè)務(wù)需求組裝成List<List<String>>格式，導(dǎo)出數(shù)據(jù)也是。

一 .業(yè)務(wù)代碼

@Test
    void excelTest(){
        // 1. 動(dòng)態(tài)構(gòu)建表頭（一級和二級）
        List<List<String>> headList = new ArrayList<>();

        // 為每個(gè)單元格設(shè)置完整的表頭路徑
        headList.add(new ArrayList<>(Arrays.asList("id")));
        headList.add(new ArrayList<>(Arrays.asList("學(xué)院", "學(xué)院名稱")));
        headList.add(new ArrayList<>(Arrays.asList("學(xué)院", "學(xué)院代碼")));
        headList.add(new ArrayList<>(Arrays.asList("學(xué)生信息", "姓名")));
        headList.add(new ArrayList<>(Arrays.asList("學(xué)生信息", "學(xué)號")));
        headList.add(new ArrayList<>(Arrays.asList("成績", "數(shù)學(xué)")));
        headList.add(new ArrayList<>(Arrays.asList("成績", "語文")));

        // 2. 準(zhǔn)備內(nèi)容數(shù)據(jù)（每行列數(shù)與二級表頭一致）
        List<List<Object>> dataList = new ArrayList<>();
        dataList.add(new ArrayList<>(Arrays.asList("123","計(jì)算機(jī)學(xué)院", "CS001", "張三", "S1001", 90, 85)));
        dataList.add(new ArrayList<>(Arrays.asList("324","計(jì)算機(jī)學(xué)院", "CS001", "李四", "S1002", 88, 92)));
        dataList.add(new ArrayList<>(Arrays.asList("966","文學(xué)院", "LA002", "王五", "S2001", 78, 95)));

        // 3. 自定義表頭字體格式樣式
        WriteCellStyle headWriteCellStyle = ExcelHeadStyle.writExcelHeadStyle();
        
        // 4. 應(yīng)用樣式策略
        HorizontalCellStyleStrategy horizontalCellStyleStrategy =
                new HorizontalCellStyleStrategy(headWriteCellStyle, new WriteCellStyle());

        // 5. 導(dǎo)出 Excel 并應(yīng)用樣式
        String fileName = "dynamic_header_with_style.xlsx";
        EasyExcel.write(fileName)
                .head(headList)
                .registerWriteHandler(horizontalCellStyleStrategy)  // 注冊樣式處理器
                .registerWriteHandler(new ExcelCellWriteHandler()) // 注冊自適應(yīng)列寬
                .sheet("學(xué)生成績表")
                .doWrite(dataList);
    }

二. 表頭樣式實(shí)現(xiàn)

/**
 * @Description Excel表頭樣式
 * @Author dhp
 * @create 2025-06-09 15:13
 */
public class ExcelHeadStyle {

    /**
     * 設(shè)置表頭字體格式樣式
     * @return
     */
    public static WriteCellStyle writExcelHeadStyle(){
        WriteCellStyle headWriteCellStyle = new WriteCellStyle();
        // 設(shè)置表頭居中對齊
        headWriteCellStyle.setHorizontalAlignment(HorizontalAlignment.CENTER);

        // 創(chuàng)建字體樣式
        WriteFont headWriteFont = new WriteFont();
        headWriteFont.setFontName("宋體");  // 設(shè)置字體
        headWriteFont.setFontHeightInPoints((short) 12);  // 設(shè)置字號
        headWriteFont.setBold(true);  // 加粗
        headWriteCellStyle.setWriteFont(headWriteFont);

        // 設(shè)置背景顏色
        headWriteCellStyle.setFillForegroundColor(IndexedColors.GREY_25_PERCENT.getIndex());
        headWriteCellStyle.setFillPatternType(FillPatternType.SOLID_FOREGROUND);
        return headWriteCellStyle;
    }

}

三.表頭和單元格列寬調(diào)整策略

自動(dòng)適應(yīng)合適的列寬

**
 * 單元格列寬調(diào)整策略
 * @Description
 * @Author dhp
 * @create 2025-06-09 14:55
 */
public class ExcelCellWriteHandler extends AbstractColumnWidthStyleStrategy {
    private static final int MAX_COLUMN_WIDTH = 255;
    private static final int MIN_COLUMN_WIDTH = 8;

    @Override
    protected void setColumnWidth(WriteSheetHolder writeSheetHolder, List<WriteCellData<?>> cellDataList, Cell cell, Head head, Integer relativeRowIndex, Boolean isHead) {
        int columnIndex = cell.getColumnIndex();
        Sheet sheet = writeSheetHolder.getSheet();

        // 如果是表頭，直接設(shè)置寬度
        if (isHead) {
            String text = cell.getStringCellValue();
            int width = text.length() * 2 + 2;
            width = Math.min(width, MAX_COLUMN_WIDTH);
            width = Math.max(width, MIN_COLUMN_WIDTH);
            sheet.setColumnWidth(columnIndex, width * 256);
        }
        // 如果是內(nèi)容單元格，計(jì)算并比較是否需要更新寬度
        else {
            // 獲取當(dāng)前列寬
            int currentWidth = sheet.getColumnWidth(columnIndex) / 256;

            // 計(jì)算內(nèi)容所需寬度
            int contentWidth = calculateCellWidth(cell);
            contentWidth = Math.min(contentWidth, MAX_COLUMN_WIDTH);
            contentWidth = Math.max(contentWidth, MIN_COLUMN_WIDTH);

            // 如果內(nèi)容比當(dāng)前列寬更寬，則更新列寬
            if (contentWidth > currentWidth) {
                sheet.setColumnWidth(columnIndex, contentWidth * 256);
            }
        }
    }

    /**
     * 根據(jù)單元格內(nèi)容計(jì)算合適的寬度
     * @param cell
     * @return
     */
    private int calculateCellWidth(Cell cell) {
        String text;
        switch (cell.getCellType()) {
            case STRING:
                text = cell.getStringCellValue();
                break;
            case NUMERIC:
                if (DateUtil.isCellDateFormatted(cell)) {
                    text = cell.getDateCellValue().toString();
                } else {
                    text = String.valueOf(cell.getNumericCellValue());
                }
                break;
            case BOOLEAN:
                text = String.valueOf(cell.getBooleanCellValue());
                break;
            case FORMULA:
                text = cell.getCellFormula();
                break;
            default:
                text = "";
        }

        // 簡單計(jì)算：中文字符算2個(gè)寬度，其他算1個(gè)
        int width = 0;
        for (char c : text.toCharArray()) {
            //0x4E00 到 0x9FA5 是 Unicode 中 CJK 統(tǒng)一表意文字的范圍（即中文字符）
            width += (c >= 0x4E00 && c <= 0x9FA5) ? 2 : 1;
        }

        return width + 2; // 加2作為邊距
    }
}