Java 导出 Excel 的主流方案：POI、EasyExcel 与模板引擎实战

二、基于 Alibaba EasyExcel（推荐）

EasyExcel 是阿里巴巴开源的 Excel 处理工具，基于 POI 封装，专注于简化代码和优化大数据量性能，有效避免 POI 的内存占用问题。

核心特点

• 注解驱动：通过 @ExcelProperty 等注解映射 Java 对象与 Excel 列，无需手动创建单元格。
• 低内存：默认采用 SXSSF 的内存优化机制，支持百万级数据导出。
• 支持复杂格式：合并单元格、表头样式、自定义转换器等。

优缺点分析

• 优点：代码简洁，降低开发成本；性能优异，适合报表、日志数据等大数据量场景。
• 缺点：高级格式（如公式、图表）支持较弱，复杂场景仍需结合 POI。

示例代码

// 定义数据模型（通过注解映射 Excel 列）
@Data
public class User {
    @ExcelProperty("姓名")
    private String name;
    
    @ExcelProperty("年龄")
    private Integer age;
}

// 导出逻辑
List<User> data = new ArrayList<>();
data.add(new User("张三", 25));

// 输出到文件
EasyExcel.write("test_easy.xlsx", User.class)
    .sheet("Sheet1")
    .doWrite(data);

三、基于 JXL（仅支持.xls）

JXL（Java Excel API）是早期的 Excel 处理工具，仅支持.xls 格式，目前已停止维护，逐渐被 POI 替代。

优缺点分析

• 优点：轻量级，API 简单，适合简单的.xls 文件导出。
• 缺点：不支持.xlsx 格式，功能有限（如不支持公式、图表），且不再更新。

示例代码

// 创建.xls 文档
WritableWorkbook workbook = Workbook.createWorkbook(new File("test_jxl.xls"));
WritableSheet sheet = workbook.createSheet("Sheet1", 0);

// 标题行
Label nameLabel = new Label(0, 0, "姓名");
Label ageLabel = new Label(1, 0, "年龄");
sheet.addCell(nameLabel);
sheet.addCell(ageLabel);

// 数据行
Label name = new Label(0, 1, "张三");
Number age = new Number(1, 1, 25);
sheet.addCell(name);
sheet.addCell(age);

workbook.write();
workbook.close();

四、基于模板引擎（如 Freemarker、Thymeleaf）

通过 Excel 模板（如.xlsx 模板）结合模板引擎，动态填充数据后导出。适用于格式固定、样式复杂的报表（如财务报表、合同模板）。

原理

1. 准备 Excel 模板，用占位符（如 ${name}）标记需要填充的位置。
2. 用模板引擎解析模板，替换占位符为实际数据。
3. 生成最终 Excel 文件。

优缺点分析

• 优点：样式与逻辑分离，模板可由非开发人员（如运营）维护；适合复杂格式报表，无需代码中手动设置样式。
• 缺点：灵活性较低，模板变更需同步更新占位符；大数据量场景性能较差。

示例（Freemarker）

模板文件（template.xlsx.ftl）中单元格设置为 ${user.name}。

Configuration cfg = new Configuration(Configuration.VERSION_2_3_31);
cfg.setDirectoryForTemplateLoading(new File("templates"));
Template template = cfg.getTemplate("template.xlsx.ftl");
Map<String, Object> data = new HashMap<>();
data.put("user", new User("张三", 25));

FileOutputStream fos = new FileOutputStream("report.xlsx");
template.process(data, new OutputStreamWriter(fos));
fos.close();

五、基于 CSV 格式（伪 Excel）

CSV（逗号分隔值）是一种简单的文本格式，可被 Excel 直接打开，适合纯数据导出（无格式要求）。

优缺点分析

• 优点：实现简单，无需依赖任何 Excel 类库；生成速度快，适合超大数据量（如千万级）。
• 缺点：不支持任何样式（如单元格合并、颜色、公式），仅能存储纯文本数据。

示例代码

FileWriter writer = new FileWriter("data.csv");
// 标题行
writer.write("姓名，年龄\n");
// 数据行
writer.write("张三，25\n");
writer.write("李四，30\n");
writer.close();

六、其他工具

• Aspose.Cells：商业工具，功能强大（支持所有 Excel 特性），但需要付费授权，适合企业级复杂场景。
• JXLS：结合 POI 和模板引擎，通过标签（如 jx:each）在 Excel 模板中循环填充数据，适合动态报表。