java怎么导出poi报表

以下是关于 Java 使用 Apache POI 导出报表 的详细教程，涵盖核心概念、完整代码示例、最佳实践及常见问题解决方案：

技术选型与基础准备

1 为什么选择 Apache POI？

Apache POI 是 Java 操作 Microsoft Office 文档的标准库，支持以下特性：

| 组件 | 描述 | 适用场景 |

|————|——————————-|————————|

| XSSF | .xlsx (Excel 2007+) | 新项目首选 |

| HSSF | .xls (Excel 97-2003) | 兼容旧版Office |

| HWPF | Word 文档 | 复杂排版需求 |

| HSLF | PowerPoint 幻灯片 | 演示文稿自动化 |

2 环境配置

Maven 依赖（推荐）：

<dependency> <groupId>org.apache.poi</groupId> <artifactId>poi-ooxml</artifactId> <version>5.2.3</version> <!-最新稳定版 --> </dependency> <dependency> <groupId>org.apache.commons</groupId> <artifactId>commons-collections4</artifactId> <version>4.4</version> </dependency>

️ 注意：若需支持 .xls 格式，需额外添加 poi 依赖。

核心开发流程详解

1 创建 Excel 文件骨架

import org.apache.poi.ss.usermodel.; import org.apache.poi.xssf.usermodel.XSSFWorkbook; import java.io.FileOutputStream; import java.util.Date; public class ExcelExporter { public static void main(String[] args) throws Exception { // 1. 创建工作簿（XSSF=xlsx, HSSF=xls） Workbook workbook = new XSSFWorkbook(); // 默认生成xlsx格式 // 2. 创建工作表并命名 Sheet sheet = workbook.createSheet("销售统计"); // 3. 定义表头样式 CellStyle headerStyle = workbook.createCellStyle(); Font headerFont = workbook.createFont(); headerFont.setBold(true); // 加粗 headerFont.setColor(IndexedColors.BLACK.getIndex()); // 字体颜色 headerStyle.setFont(headerFont); // 应用字体 headerStyle.setFillForegroundColor(IndexedColors.GREY_25_PERCENT.getIndex()); // 背景色 headerStyle.setAlignment(HorizontalAlignment.CENTER); // 水平居中 // 4. 写入表头数据 Row headerRow = sheet.createRow(0); // 第1行（索引从0开始） String[] headers = {"ID", "产品名称", "单价", "销量", "总金额", "下单日期"}; for (int i = 0; i < headers.length; i++) { Cell cell = headerRow.createCell(i); cell.setCellValue(headers[i]); cell.setCellStyle(headerStyle); // 应用样式 } // 5. 填充动态数据（模拟数据库查询结果） Object[][] data = { {1, "笔记本电脑", 5999.0, 120, 719880.0, new Date()}, {2, "智能手机", 2999.0, 350, 1049650.0, new Date()}, {3, "平板电脑", 1999.0, 80, 159920.0, new Date()} }; // 6. 数据行样式配置 CellStyle dataStyle = workbook.createCellStyle(); dataStyle.setAlignment(HorizontalAlignment.CENTER); dataStyle.setDataFormat(workbook.getCreationHelper().createDataFormat().getFormat("#,##0.00")); // 数值格式化 // 7. 遍历数据写入行 for (int rowNum = 0; rowNum < data.length; rowNum++) { Row row = sheet.createRow(rowNum + 1); // 跳过表头行 Object[] colData = data[rowNum]; for (int colNum = 0; colNum < colData.length; colNum++) { Cell cell = row.createCell(colNum); if (colData[colNum] instanceof Date) { cell.setCellValue((Date) colData[colNum]); // 设置日期格式 CellStyle dateStyle = workbook.createCellStyle(); dateStyle.cloneStyleFrom(dataStyle); dateStyle.setDataFormat(workbook.getCreationHelper().createDataFormat().getFormat("yyyy-MM-dd")); cell.setCellStyle(dateStyle); } else if (colData[colNum] instanceof Number) { cell.setCellValue((Double) colData[colNum]); cell.setCellStyle(dataStyle); // 应用数值格式 } else { cell.setCellValue(colData[colNum].toString()); } } } // 8. 自动调整列宽（根据内容自适应） for (int i = 0; i < headers.length; i++) { sheet.autoSizeColumn(i); // 逐列调整宽度 } // 9. 冻结窗格（固定表头） sheet.createFreezePane(0, 1); // 冻结首行+首列 // 10. 写入到文件系统 try (FileOutputStream outputStream = new FileOutputStream("销售报表_" + System.currentTimeMillis() + ".xlsx")) { workbook.write(outputStream); } finally { workbook.close(); // 释放资源 } } }

2 关键功能解析表

进阶技巧与最佳实践

1 大数据量处理优化

• SXSSFEventUserModel：流式API，适合百万级数据（内存占用降低90%） import org.apache.poi.ss.util.StreamingReader; import org.apache.poi.xssf.streaming.SXSSFWorkbook;

// 创建流式工作簿（最多保留100行内存）

SXSSFWorkbook wb = new SXSSFWorkbook(100);

Sheet sh = wb.createSheet();

// …写入数据…

wb.write(outputStream); // 直接写入输出流

wb.dispose(); // 清理临时文件

分页导出：按固定行数拆分多个Sheet，避免单个文件过大。 # 3.2 动态列宽计算 ```java最大宽度调整列宽（单位：磅） for (int i = 0; i < maxColumns; i++) { sheet.trackColumnForAutoSizing(i); // 标记需要自动调整的列 sheet.autoSizeColumn(i, true); // true表示基于所有行的宽度计算 }

3 复杂表头设计

通过多层嵌套实现三级表头：

// 第一层表头（大分类） Row catRow = sheet.createRow(currentRow++); catRow.createCell(0).setCellValue("电子产品"); catRow.createCell(3).setCellValue("家居用品"); // 第二层子分类（合并单元格） sheet.addMergedRegion(new CellRangeAddress(currentRow, currentRow, 0, 2)); // 合并A-C列 Row subCatRow = sheet.createRow(currentRow); subCatRow.createCell(0).setCellValue("数码设备");

典型错误及解决方案

相关问答FAQs

Q1: 导出的Excel文件中中文显示乱码怎么办？

A: 这是由于默认使用的字体不支持中文导致的，解决方法有两种：

1. 指定中文字体：在创建Font对象时设置字体名称为系统中存在的中文字体（如”宋体”、”微软雅黑”）。 Font font = workbook.createFont(); font.setFontName("微软雅黑"); // Windows系统常用字体 font.setCharSet(FontCharSet.DEFAULT_CHARSET); // 确保字符集正确
2. 嵌入字体文件：将TTF字体文件打包到项目中，通过InputStream加载： InputStream is = new FileInputStream("simhei.ttf"); Font font = workbook.createFont(); font.setFontName("SiHei"); // 字体名称需与文件名一致 font.setFontCharSet(FontCharSet.UTF_8); // 强制使用UTF-8编码

Q2: 如何动态设置每列的不同宽度？

A: 可以通过两种方式实现：

1. 精确像素控制：使用sheet.setColumnWidth(columnIndex, widthUnits)，其中widthUnits的单位是1/256个字符宽度。 // 设置第2列（B列）宽度为30个字符宽度 sheet.setColumnWidth(1, 30 256); // 1代表B列（索引从0开始）
2. 自动适配内容：调用sheet.autoSizeColumn(columnIndex)，该方法会根据该列中最宽的内容自动调整宽度，注意：此方法应在所有数据写入完成后调用。 // 在所有数据写入完成后调用 for (int i = 0; i < maxColumns; i++) { sheet.autoSizeColumn(i); // 逐列自动调整宽度 }

   ️ 提示：autoSizeColumn会影响性能，建议仅