当 Excel 导出需求同时摆在 EasyPoi 和 EasyExcel 面前时，你其实是在回答两个问题：你愿意为开发效率牺牲多少内存？你愿意为极致性能付出多少代码复杂度？两者都基于 Apache POI，却走向了完全不同的技术路线——一个用注解把所有复杂逻辑藏在背后，一个用流式写入把内存压到极致。

一、基础与定义：同源异途的 Excel 处理方案

EasyPoi 和 EasyExcel 都是基于 Apache POI 二次封装的 Java Excel 处理工具库，但设计目标和适用场景截然不同 。

维度	EasyPoi	EasyExcel
开发方	个人开发者（cn.afterturn）	阿里巴巴开源团队
核心定位	简化复杂 Excel 操作，注解驱动	极致性能，低内存消耗
设计哲学	“让 Office 操作变得容易”	“尽可能节约内存”
解析方式	DOM 解析（一次读入内存）	SAX 解析（逐行读取）
适用数据量	≤ 5 万行	百万级稳定

EasyPoi 的口号是“让没接触过 POI 的开发者也能轻松写出文档处理功能”；EasyExcel 的目标则是“在几十 MB 内存中处理上百 MB 的 Excel 文件” 。

二、核心特点与特性

2.1 EasyPoi 核心特性

注解驱动的极简开发：只需在实体类字段上添加 @Excel 注解，即可完成列映射、格式、合并等全部配置。原本需要数百行的 POI 操作，浓缩为几十行注解 + 一行导出代码 。

内置一对多合并：@ExcelCollection + needMerge = true 自动处理层级数据的纵向合并，无需手写合并算法 。

模板引擎支持：支持 Word/Excel 模板导出，通过 {{}} 表达式实现动态数据填充、循环、条件判断 。

功能广度：同时支持 Excel（xls/xlsx）、Word（docx）、PDF 多种格式，覆盖场景更广 。

2.2 EasyExcel 核心特性

流式写入，内存可控：采用 SAX 模式逐行解析，默认缓存阈值仅 1MB，有效避免 OOM 。原本 3MB 的 Excel 用 POI 需要 100MB 内存，EasyExcel 可降至几 MB 。

事件驱动模型：通过 AnalysisEventListener 回调机制，每解析完一行触发一次事件，处理完成后释放内存 。

异步处理支持：支持异步导入导出，适合批处理任务 。

阿里生态背书：更新频繁，社区活跃，生产验证充分。

三、优缺点深度对比

3.1 EasyPoi 优缺点

优点：

• 开发效率极高：注解驱动，一行代码完成导出 

• 自动合并单元格：needMerge = true 一键搞定 

• Word 模板支持：同时覆盖 Excel + Word 

• 学习曲线平缓：文档和社区案例丰富 

缺点：

• 内存占用高：DOM 解析方式在大数据量下易 OOM 

• 高并发不稳定：实测 10 线程 3 万条导出即触发 OOM 

• 维护活跃度下降：近 2-3 年更新频率低

3.2 EasyExcel 优缺点

优点：

• 极致内存控制：逐行读写，百万级数据稳定 

• 高性能：相同数据量下处理速度比 POI 快 3-5 倍 

• 多线程稳定性强：10 线程 6.5 万条仍有响应，EasyPoi 在 3 万条已崩溃 

• 阿里持续维护：版本迭代快，社区活跃

缺点：

• 合并逻辑需手写：不自带自动合并，需自定义 CellWriteHandler 

• 仅支持 Excel：不支持 Word/PDF 

• 嵌套结构处理复杂：需要先将树形数据“拍平” 

四、性能实测数据

基于 -Xms512m -Xmx512m 环境的实测结果 ：

测试场景	EasyPoi	EasyExcel
单线程 6.5 万行	内存增量 714MB，偶发 Full GC	内存增量 1.6GB，无 Full GC
10 线程 3 万行	❌ OOM 崩溃	✅ 频繁 Full GC 后成功
导出耗时（单线程）	约 2.5 秒	约 2 秒
10 线程导出耗时	—	约 16 秒（Full GC 停顿）

五、选型建议

场景	推荐方案	理由
复杂层级报表（≤5 万行）	EasyPoi	注解 + needMerge 自动合并，开发效率最高
百万级大数据量导出	EasyExcel	流式写入，内存可控
Word 合同/证书生成	EasyPoi	Word 模板导出能力独有
高并发导出场景	EasyExcel	多线程稳定性更强
快速原型开发	EasyPoi	注解驱动，一行代码搞定

六、代码示例

6.1 EasyPoi 注解方式导出

java

@Data
public class OrderExportVO {
    @Excel(name = "订单编号", needMerge = true, width = 20)
    private String orderNo;
    
    @Excel(name = "客户名称", needMerge = true)
    private String customerName;
    
    @Excel(name = "订单日期", format = "yyyy-MM-dd")
    private Date orderDate;
    
    @ExcelCollection(name = "商品明细")
    private List<OrderItemVO> items;
}

// 导出
ExportParams params = new ExportParams("订单报表", "订单");
Workbook workbook = ExcelExportUtil.exportExcel(params, OrderExportVO.class, dataList);
workbook.write(new FileOutputStream("订单.xls"));

6.2 EasyExcel 大数据量导出

java

// 写法1：分页查询 + 流式写入
EasyExcel.write(fileName, DemoData.class)
    .sheet("模板")
    .doWrite(() -> {
        // 分页查询数据，每次返回 1000 条
        return pageQuery();
    });

// 导入 + 监听器
EasyExcel.read(fileName, User.class, new PageReadListener<User>(dataList -> {
    // 每批处理 100 条
    userService.batchSave(dataList);
})).sheet().doRead();

七、总结

EasyPoi 和 EasyExcel 本质上是两种不同工程哲学的代表：EasyPoi 用内存换开发效率，EasyExcel 用代码复杂度换极致性能。

• 数据量小（<5 万行）、结构复杂、需要快速交付 → EasyPoi

• 数据量大（>10 万行）、高并发、追求稳定性 → EasyExcel

两者并非对立，而是覆盖不同场景的技术选项。在生产环境中，甚至可以混合使用：EasyPoi 处理复杂报表模板，EasyExcel 处理大批量数据导入导出。关键不在于“哪个更好”，而在于“哪个更适合你当前的约束条件”。