作为频繁用 POI 做导出功能的实习生，整理了这份「高频方法速查表 + 实战避坑指南」，涵盖 Workbook、Sheet、Row、Cell、样式、合并等核心操作，直接复制能用，遇到问题快速对应排查，效率翻倍～

一、POI 核心操作速查（按组件分类）

1. 基础准备（依赖 + Workbook 创建）

2. Sheet（工作表）操作

3. Row（行）操作

4. Cell（单元格）操作

5. 样式（CellStyle）操作（高频）

6. 合并单元格操作（行 / 列 / 复杂）

7. 导出响应设置（前端下载）

二、POI 避坑指南（实习生实战踩坑总结）

1. 数据显示类坑

2. 格式错乱类坑

3. 性能 / 报错类坑

4. 逻辑类坑

三、快速复用模板（核心代码片段）

1. 日期样式模板（直接复制）

// 创建日期样式（避免日期显示为数字）
private static CellStyle createDateStyle(Workbook workbook) {
    CellStyle style = workbook.createCellStyle();
    // 绑定字体
    Font font = workbook.createFont();
    font.setFontName("微软雅黑");
    font.setFontHeightInPoints((short)11);
    style.setFont(font);
    // 日期格式化
    DataFormat dataFormat = workbook.createDataFormat();
    style.setDataFormat(dataFormat.getFormat("yyyy-MM-dd HH:mm:ss"));
    // 居中+边框
    style.setAlignment(HorizontalAlignment.CENTER);
    style.setVerticalAlignment(VerticalAlignment.CENTER);
    style.setBorderTop(BorderStyle.THIN);
    style.setBorderBottom(BorderStyle.THIN);
    style.setBorderLeft(BorderStyle.THIN);
    style.setBorderRight(BorderStyle.THIN);
    return style;
}

2. 行合并核心模板（同一员工多记录）

// 数据分组（按姓名+工号）
Map<String, List<MyAttendance>> empGroup = attendanceList.stream()
        .collect(Collectors.groupingBy(att -> att.getEmpName() + "-" + att.getEmpNo()));

// 遍历分组填充数据
int currentRow = 3; // 数据行从第4行开始（前3行标题）
for (Map.Entry<String, List<MyAttendance>> entry : empGroup.entrySet()) {
    List<MyAttendance> empAtts = entry.getValue();
    int recordCount = empAtts.size();
    int mergeStartRow = currentRow;
    int mergeEndRow = currentRow + recordCount - 1;

    // 合并主列（0-10列，共11列）
    for (int col = 0; col < 11; col++) {
        CellRangeAddress mergeRange = new CellRangeAddress(mergeStartRow, mergeEndRow, col, col);
        sheet.addMergedRegion(mergeRange);
    }

    // 填充每条记录
    for (int i = 0; i < recordCount; i++) {
        MyAttendance att = empAtts.get(i);
        Row row = sheet.createRow(currentRow);
        // 主列只在首行填数据
        if (i == 0) {
            row.createCell(0).setCellValue(att.getMonth());
            row.createCell(1).setCellValue(att.getShopName());
            // ... 其他主列
        }
        // 日期子列填当日数据
        int dateCol = 11 + (att.getDate() - 1) * 3;
        row.createCell(dateCol).setCellValue(att.getCheckResult());
        // ... 其他子列
        currentRow++;
    }
}