JAVA Apache POI实战：从基础Excel导出入门到高级功能拓展

一、Apache POI简介

Apache POI是Apache软件基金会的开源项目，全称"Poor Obfuscation Implementation"（简陋模糊化实现），主要用于Java程序对Microsoft Office格式文件（如Excel、Word、PowerPoint等）进行读写操作。

核心组件：

HSSF：操作Excel 97-2003格式（.xls）
XSSF：操作Excel 2007+格式（.xlsx）
SXSSF：XSSF的流式API，适合大数据量
HWPF：操作Word文档
HSLF：操作PowerPoint

二、基础Excel导出实战

2.1 最小化示例（导出.xls）

// 创建Excel工作簿（HSSF对应.xls格式）
Workbook workbook = new HSSFWorkbook();
// 创建工作表
Sheet sheet = workbook.createSheet("员工表");// 创建表头行（第0行）
Row headerRow = sheet.createRow(0);
headerRow.createCell(0).setCellValue("姓名");
headerRow.createCell(1).setCellValue("年龄");
headerRow.createCell(2).setCellValue("部门");// 添加数据行（第1行）
Row dataRow = sheet.createRow(1);
dataRow.createCell(0).setCellValue("张三");
dataRow.createCell(1).setCellValue(28);
dataRow.createCell(2).setCellValue("研发部");// 写入到文件
try (FileOutputStream fos = new FileOutputStream("员工表.xls")) {workbook.write(fos);
}

2.2 新版Excel导出（.xlsx）

// 使用XSSFWorkbook创建.xlsx文件
Workbook workbook = new XSSFWorkbook();
// 其余操作与HSSF完全相同

2.3 添加简单样式

// 创建单元格样式
CellStyle headerStyle = workbook.createCellStyle();
Font headerFont = workbook.createFont();
headerFont.setBold(true);                 // 加粗
headerFont.setFontHeightInPoints((short)12); // 字号
headerStyle.setFont(headerFont);
headerStyle.setFillForegroundColor(IndexedColors.GREY_25_PERCENT.getIndex()); // 背景色
headerStyle.setFillPattern(FillPatternType.SOLID_FOREGROUND);// 应用样式到表头
for (int i = 0; i < headerRow.getLastCellNum(); i++) {headerRow.getCell(i).setCellStyle(headerStyle);
}

三、中级功能进阶

3.1 大数据量导出（SXSSF）

// 创建SXSSF工作簿（保留100行在内存中）
Workbook workbook = new SXSSFWorkbook(100); try {Sheet sheet = workbook.createSheet("大数据表");// 写入10万行数据for (int i = 0; i < 100000; i++) {Row row = sheet.createRow(i);row.createCell(0).setCellValue("数据" + i);row.createCell(1).setCellValue(Math.random() * 100);// 每1000行手动flush一次if (i % 1000 == 0) {((SXSSFSheet)sheet).flushRows(100); // 保留最近100行}}// 写入文件workbook.write(new FileOutputStream("大数据.xlsx"));
} finally {// 必须显式清理临时文件if (workbook instanceof SXSSFWorkbook) {((SXSSFWorkbook)workbook).dispose();}
}

3.2 合并单元格

// 合并A1到D1单元格
sheet.addMergedRegion(new CellRangeAddress(0, 0, 0, 3));// 创建合并单元格
Row mergedRow = sheet.createRow(0);
Cell mergedCell = mergedRow.createCell(0);
mergedCell.setCellValue("季度销售报表");// 设置合并单元格样式
CellStyle mergedStyle = workbook.createCellStyle();
mergedStyle.setAlignment(HorizontalAlignment.CENTER);
mergedCell.setCellStyle(mergedStyle);

3.3 添加公式

// 添加SUM公式
Row formulaRow = sheet.createRow(sheet.getLastRowNum() + 1);
formulaRow.createCell(0).setCellValue("合计");
formulaRow.createCell(1).setCellFormula("SUM(B2:B" + (sheet.getLastRowNum()) + ")");// 强制计算公式（可选）
workbook.getCreationHelper().createFormulaEvaluator().evaluateAll();

四、高级功能拓展

4.1 条件格式

// 创建条件格式规则
SheetConditionalFormatting scf = sheet.getSheetConditionalFormatting();// 定义格式：数值大于90显示绿色背景
ConditionalFormattingRule rule = scf.createConditionalFormattingRule("B2>90");
PatternFormatting fill = rule.createPatternFormatting();
fill.setFillBackgroundColor(IndexedColors.LIGHT_GREEN.getIndex());
fill.setFillPattern(PatternFormatting.SOLID_FOREGROUND);// 应用范围：B2到B100
CellRangeAddress[] regions = { CellRangeAddress.valueOf("B2:B100") };
scf.addConditionalFormatting(regions, rule);

4.2 数据验证（下拉列表）

// 创建数据验证约束
DataValidationHelper dvHelper = sheet.getDataValidationHelper();
DataValidationConstraint dvConstraint = dvHelper.createExplicitListConstraint(new String[]{"研发部","市场部","财务部","人事部"});// 设置验证范围（C列）
CellRangeAddressList addressList = new CellRangeAddressList(1, 100, 2, 2); // 从第2行到101行，第3列// 创建数据验证
DataValidation validation = dvHelper.createValidation(dvConstraint, addressList);
validation.setShowErrorBox(true);
sheet.addValidationData(validation);

4.3 图表生成

// 创建绘图对象
Drawing<?> drawing = sheet.createDrawingPatriarch();// 定义图表位置
ClientAnchor anchor = drawing.createAnchor(0, 0, 0, 0, 5, 1, 10, 15);// 创建柱状图
Chart chart = drawing.createChart(anchor);
ChartLegend legend = chart.getOrCreateLegend();
legend.setPosition(LegendPosition.BOTTOM);// 定义数据源
BarChartData data = chart.getChartDataFactory().createBarChartData(ChartAxisFactory.createValueAxis(chart), ChartAxisFactory.createCategoryAxis(chart)
);// 设置系列数据
ChartDataSource<String> cats = DataSources.fromStringCellRange(sheet, new CellRangeAddress(1, 4, 0, 0));
ChartDataSource<Number> values = DataSources.fromNumericCellRange(sheet, new CellRangeAddress(1, 4, 1, 1));
data.addSeries(cats, values, "部门业绩");// 应用数据到图表
chart.plot(data);

五、实际应用技巧

5.1 性能优化建议

对象复用：重复使用CellStyle对象

// 错误的做法：每次循环都创建新样式
// 正确的做法：预先创建样式对象并复用
CellStyle dataStyle = workbook.createCellStyle();
for (Row row : sheet) {for (Cell cell : row) {cell.setCellStyle(dataStyle);}
}

批量写入：使用SXSSF处理大数据

// 设置窗口大小（内存中保留的行数）
SXSSFWorkbook workbook = new SXSSFWorkbook(100);

及时清理：处理完成后释放资源

try {// 操作workbook...
} finally {if (workbook instanceof SXSSFWorkbook) {((SXSSFWorkbook)workbook).dispose();}
}

5.2 常见问题解决方案

问题1：导出文件损坏

确保正确关闭流
使用try-with-resources语句块

问题2：内存溢出

对于大数据量使用SXSSF
设置合理的flush间隔

问题3：日期格式问题

CellStyle dateStyle = workbook.createCellStyle();
CreationHelper createHelper = workbook.getCreationHelper();
dateStyle.setDataFormat(createHelper.createDataFormat().getFormat("yyyy-MM-dd"));
cell.setCellValue(new Date());
cell.setCellStyle(dateStyle);

六、扩展应用场景

6.1 与Web集成（Spring Boot示例）

@GetMapping("/export")
public void exportExcel(HttpServletResponse response) throws IOException {// 设置响应头response.setContentType("application/vnd.openxmlformats-officedocument.spreadsheetml.sheet");response.setHeader("Content-Disposition", "attachment; filename=export.xlsx");// 创建ExcelWorkbook workbook = new XSSFWorkbook();// ...填充数据// 写入响应流workbook.write(response.getOutputStream());workbook.close();
}

6.2 读取Excel数据

public List<Employee> readExcel(File file) throws IOException {List<Employee> employees = new ArrayList<>();try (Workbook workbook = WorkbookFactory.create(file)) {Sheet sheet = workbook.getSheetAt(0);for (Row row : sheet) {if (row.getRowNum() == 0) continue; // 跳过表头Employee emp = new Employee();emp.setName(row.getCell(0).getStringCellValue());emp.setAge((int)row.getCell(1).getNumericCellValue());emp.setDepartment(row.getCell(2).getStringCellValue());employees.add(emp);}}return employees;
}

6.3 模板导出（基于现有Excel模板）

public void exportWithTemplate() throws IOException {// 加载模板文件try (InputStream is = new FileInputStream("template.xlsx");Workbook workbook = new XSSFWorkbook(is)) {Sheet sheet = workbook.getSheetAt(0);// 在模板指定位置填充数据sheet.getRow(5).getCell(3).setCellValue("张三");sheet.getRow(6).getCell(3).setCellValue(new Date());// 保存为新文件try (FileOutputStream fos = new FileOutputStream("output.xlsx")) {workbook.write(fos);}}
}