使用 EasyExcel 实现高效的 Excel 读写操作

在日常开发中，Excel 文件的读写操作是一个常见的需求。EasyExcel 是阿里巴巴开源的一个高性能、易用的 Excel 读写库，可以大幅提高处理 Excel 文件的效率。它通过事件驱动模型优化了大数据量 Excel 的读写性能，非常适合处理大文件或高并发场景。

本篇博客将从 EasyExcel 的基本概念、优势、安装、读写操作以及高级用法展开，并提供清晰的代码示例。

一、EasyExcel 的核心特点

高性能：基于流式解析，低内存消耗，适合大数据量操作。
简单易用：提供了强大的注解支持，配置简单。
兼容性强：支持 Excel 2007（.xlsx）及更高版本。
事件驱动模型：按需读取，避免一次性加载所有数据到内存。
支持复杂表头：可以轻松处理多级表头、合并单元格等复杂场景。

二、安装 EasyExcel

首先，在你的 Maven 项目中引入 EasyExcel 的依赖：

<dependency><groupId>com.alibaba</groupId><artifactId>easyexcel</artifactId><version>4.0.3</version> <!-- 请使用最新版本 -->
</dependency>

三、基本用法

1. 写入 Excel

以下是一个简单的 Excel 写入示例：

import com.alibaba.excel.EasyExcel;import java.util.ArrayList;
import java.util.List;public class EasyExcelWriteExample {public static void main(String[] args) {String fileName = "example.xlsx";// 准备数据List<UserData> data = generateData();// 写入文件EasyExcel.write(fileName, UserData.class).sheet("用户信息").doWrite(data);}private static List<UserData> generateData() {List<UserData> list = new ArrayList<>();for (int i = 1; i <= 10; i++) {list.add(new UserData(i, "用户" + i, "user" + i + "@example.com"));}return list;}// 数据类，使用注解指定表头public static class UserData {@com.alibaba.excel.annotation.ExcelProperty("用户ID")private Integer id;@com.alibaba.excel.annotation.ExcelProperty("用户名")private String name;@com.alibaba.excel.annotation.ExcelProperty("邮箱")private String email;// 构造函数、Getter 和 Setterpublic UserData(Integer id, String name, String email) {this.id = id;this.name = name;this.email = email;}}
}

说明：

@ExcelProperty 注解用于指定 Excel 列的标题。
EasyExcel.write() 是写操作的入口，指定文件路径和数据模型。

运行以上代码后，会生成一个名为 example.xlsx 的文件，包含一张标题为“用户信息”的表单。

2. 读取 Excel

以下示例展示如何读取 Excel 文件内容：

import com.alibaba.excel.EasyExcel;
import com.alibaba.excel.context.AnalysisContext;
import com.alibaba.excel.read.listener.ReadListener;import java.util.List;public class EasyExcelReadExample {public static void main(String[] args) {String fileName = "example.xlsx";// 读取文件EasyExcel.read(fileName, UserData.class, new UserDataListener()).sheet().doRead();}// 自定义监听器，处理每一行数据public static class UserDataListener implements ReadListener<UserData> {@Overridepublic void invoke(UserData data, AnalysisContext context) {System.out.println("读取到数据：" + data);}@Overridepublic void doAfterAllAnalysed(AnalysisContext context) {System.out.println("所有数据读取完毕");}}
}

四、高级功能

1. 多级表头

EasyExcel 支持复杂的多级表头：

java

复制代码

public class MultiLevelData {@com.alibaba.excel.annotation.ExcelProperty({"用户信息", "用户ID"})private Integer id;@com.alibaba.excel.annotation.ExcelProperty({"用户信息", "用户名"})private String name;@com.alibaba.excel.annotation.ExcelProperty({"联系方式", "邮箱"})private String email;
}

在写入时，会生成两级表头，分为“用户信息”和“联系方式”。

2. 大数据量读取

针对大文件，EasyExcel 提供了分批读取的能力。

EasyExcel.read(fileName, UserData.class, new ReadListener<UserData>() {@Overridepublic void invoke(UserData data, AnalysisContext context) {// 处理每一条数据}@Overridepublic void doAfterAllAnalysed(AnalysisContext context) {// 处理完成后执行}
}).sheet().doRead();

通过监听器，每次读取一小部分数据处理，避免内存溢出。