当前位置：首页 > news >正文

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

news 2025/8/16 10:59:23

在日常开发中，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();

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