Java操作Excel的最稳定方案是Apache POI和阿里EasyExcel两个库，本文提供可直接运行的Java Excel Demo代码，涵盖读写、导入导出及性能对比，可用于快速在项目中落地。
为什么你需要一个Java Excel Demo
在日常开发中,Excel导入导出几乎是每个Java后端项目都会遇到的需求，无论是生成月度报表，还是批量导入用户数据，一个可靠的Java Excel Demo能帮你快速理解核心逻辑，避免重复踩坑。
实际业务场景中的Excel操作
- 报表导出：生成销售数据、财务报表等，要求格式规范、数据准确。
- 数据导入：批量录入人员信息、订单记录，需要解析Excel并写入数据库。
- 模板下载：提供固定格式的Excel文件，供用户填写后上传。
- 数据交换：与第三方系统通过Excel进行数据同步，格式需严格匹配。
选错库的代价
行业共识认为,选择不当的Excel操作库会导致性能瓶颈、格式兼容问题甚至内存溢出，早期许多项目直接使用JXL（已停止维护），导致.xlsx格式支持不完善，从Demo阶段就选对库至关重要。
核心库对比：Java Excel 解析 工具 对比
Apache POI：功能最全面的老牌方案
Apache POI是Apache基金会下的开源项目，支持Excel 97-2003 (.xls) 和 2007+ (.xlsx) 格式，它提供HSSFWorkbook、XSSFWorkbook和SXSSFWorkbook三种模式，分别对应不同数据量场景。
- 优点：支持样式、公式、图表、合并单元格、数据验证等复杂操作。
- 缺点：XSSFWorkbook读取整个文件到内存，大数据量时易OOM，SXSSFWorkbook虽可流式写入，但功能受限。
阿里EasyExcel：为大数据量优化的轻量级方案
EasyExcel基于Apache POI开发，但采用流式读写，大幅降低内存占用，它通过注解方式映射Java对象，代码简洁。
- 优点：内存占用低，读写速度快，适合10万行以上数据。
- 缺点：复杂样式支持较弱，图形、公式、数据验证等需要额外处理。
两者对比速览
| 特性 | Apache POI | EasyExcel |
| 支持格式 | .xls, .xlsx | .xlsx为主 |
| 内存占用 | 高（全量加载） | 低（流式） |
| 学习曲线 | 中等 | 较低 |
| 社区活跃度 | 高 | 高 |
| 样式支持 | 全面 | 基本 |
| 大数据量处理 | 需SXSSFWorkbook | 原生支持 |
| 最佳应用场景 | 复杂报表、Office文档全功能操作 | 简单导入导出、大批量数据 |
（据Apache POI官方文档和EasyExcel项目主页信息整理）
实战：Java Excel 导入导出 示例完整实现
环境准备：Maven依赖
使用POI时,在pom.xml中添加：
<dependency>
<groupId>org.apache.poi</groupId>
<artifactId>poi-ooxml</artifactId>
<version>5.2.5</version>
</dependency>
使用EasyExcel时添加：
<dependency>
<groupId>com.alibaba</groupId>
<artifactId>easyexcel</artifactId>
<version>3.3.4</version>
</dependency>
注意版本兼容性,建议在项目中统一管理。
Java读取Excel文件Demo：两种方式对比
POI读取实现
try (Workbook workbook = new XSSFWorkbook("demo.xlsx")) {
Sheet sheet = workbook.getSheetAt(0);
for (Row row : sheet) {
for (Cell cell : row) {
// 根据单元格类型读取值
switch (cell.getCellType()) {
case STRING: System.out.print(cell.getStringCellValue() + "\t"); break;
case NUMERIC: System.out.print(cell.getNumericCellValue() + "\t"); break;
case BOOLEAN: System.out.print(cell.getBooleanCellValue() + "\t"); break;
default: System.out.print("--\t");
}
}
System.out.println();
}
}
注意：XSSFWorkbook加载整个文件，适用于小文件，大文件应使用XSSFReader配合SAX解析。
EasyExcel读取实现
// 定义实体类，通过注解映射列
public class DemoData {
@ExcelProperty("姓名")
private String name;
@ExcelProperty("数值")
private Double value;
// getter/setter
}
// 监听器，每读取一行调用一次
public class DemoDataListener extends AnalysisEventListener<DemoData> {
@Override
public void invoke(DemoData data, AnalysisContext context) {
System.out.println("读取到一行：" + data);
}
@Override
public void doAfterAllAnalysed(AnalysisContext context) {
System.out.println("所有行读取完成");
}
}
// 读取
EasyExcel.read("demo.xlsx", DemoData.class, new DemoDataListener()).sheet().doRead();
EasyExcel的流式读取不会一次性加载所有行,适合大数据量导入。
Java写入Excel文件实战步骤
POI写入示例
try (Workbook workbook = new XSSFWorkbook();
FileOutputStream fos = new FileOutputStream("output.xlsx")) {
Sheet sheet = workbook.createSheet("Sheet1");
// 创建表头
Row header = sheet.createRow(0);
header.createCell(0).setCellValue("姓名");
header.createCell(1).setCellValue("数值");
// 写入数据
Row row = sheet.createRow(1);
row.createCell(0).setCellValue("张三");
row.createCell(1).setCellValue(123.45);
workbook.write(fos);
}
EasyExcel写入示例
List<DemoData> dataList = new ArrayList<>();
dataList.add(new DemoData("张三", 123.45));
dataList.add(new DemoData("李四", 678.90));
EasyExcel.write("output.xlsx", DemoData.class).sheet("Sheet1").doWrite(dataList);
EasyExcel写入同样简洁,无需手动管理行和单元格，若需自定义样式，可通过WriteHandler实现。
性能优化与最佳实践：Java Excel 操作 实战 入门
大数据量导出优化
据Stack Overflow社区讨论，处理超过10万行数据时，内存溢出是开发者常遇到的痛点，使用POI时，应优先采用SXSSFWorkbook（流式写入），其默认只保留100行在内存中，其余写入临时文件：
SXSSFWorkbook workbook = new SXSSFWorkbook(); // 使用方法与XSSFWorkbook一致 // 完成后清除临时文件 workbook.dispose();
EasyExcel原生支持流式写入,无需额外配置，若数据量超过50万行，建议分批次写入并合并，或直接生成CSV格式。
模板导出与样式复用
对于复杂样式的报表,建议预置Excel模板，使用POI加载模板文件，填充数据后写出：
try (Workbook template = new XSSFWorkbook("template.xlsx")) {
Sheet sheet = template.getSheetAt(0);
// 定位并修改单元格，样式保持不变
sheet.getRow(0).getCell(0).setCellValue("新标题");
sheet.getRow(1).getCell(1).setCellValue("新数据");
try (FileOutputStream out = new FileOutputStream("result.xlsx")) {
template.write(out);
}
}
EasyExcel也支持模板填充,但样式控制能力较弱，适合简单场景，若需保留单元格样式且填充大量数据，POI更可靠。
并发处理时的注意事项
多线程写入同一个Excel文件会造成数据错乱,建议每个线程生成独立文件，最后合并，或使用同步锁写入，对于分布式的导入，可以考虑先写入数据库，再统一导出Excel，使用内存映射文件或临时文件可以降低堆内存压力。
常见错误与调试技巧
- 文件格式错误：使用
.xls扩展名但创建了XSSFWorkbook，会抛出异常，确保文件格式与Workbook类型匹配。 - 单元格类型异常：读取数值单元格时调用
getStringCellValue会失败，使用CellType判断后再取值。 - 依赖冲突：POI和EasyExcel均依赖
poi-ooxml，注意版本一致，避免jar包冲突。
Java Excel Demo常见问题解析
Q1：Java Excel Demo中，POI和EasyExcel如何选择？
A1：根据业务场景，POI功能全面，适合复杂样式、公式、图表、数据验证；EasyExcel在大数据量下性能更优，内存占用低，代码简洁，若导入导出逻辑简单且数据量大，推荐EasyExcel；若需精细控制格式，选择POI。
Q2：如何读取大Excel文件而不导致OOM？
A2：使用EasyExcel的流式读取，采用AnalysisEventListener逐行处理，不加载全量数据，若使用POI，采用XSSFReader配合SAX解析，或使用XSSFWorkbook的setMissingCellPolicy配合迭代器，但效果有限，对于超大文件（超过50万行），建议分页读取，每次处理一定行数后写入数据库，释放内存。
Q3：Excel模板导出时，如何保留原有样式和公式？
A3：POI加载模板文件后，所有样式和公式会自动保留，填充数据时，直接修改单元格值，不改变单元格样式，若需新增行，需复制样式（通过CellStyle对象），EasyExcel的模板填充也支持样式保留，但仅限于已有的单元格样式，新增行或列时样式控制较弱，推荐POI用于模板导出。（直接以事实结尾）
核心结论：一个优秀的Java Excel Demo，关键在于理解库的特性并匹配实际需求，POI和EasyExcel各有千秋，从Demo阶段开始，就应结合数据量、样式复杂度、团队技术栈等因素做出选择，有了清晰的代码示例和最佳实践，Java Excel操作不再是难题。
首发原创文章，作者：王坚，如若转载，请注明出处：https://idctop.com/article/500492.html
