EasyExcel 读取 Excel 文件指南

EasyExcel 是阿里巴巴开源的 Java Excel 处理工具，以​​事件驱动模式​​为核心，支持大文件低内存读取、灵活的数据映射及丰富的配置选项，是 Java 生态中处理 Excel 文件的高效选择。

一、前置准备：添加 EasyExcel 依赖​

<dependency>
    <groupId>com.alibaba</groupId>
    <artifactId>easyexcel</artifactId>
    <version>3.2.1</version> <!-- 版本号根据实际情况调整 -->
</dependency>

二、基础读取流程：从文件到内存​​

EasyExcel 读取 Excel 的核心流程可分为​​创建读取器→配置参数→注册监听器→执行读取​​四步：

1. 创建读取器

通过 EasyExcel.read()方法创建 ExcelReaderBuilder实例，支持传入​​文件路径（String）​​、​​文件对象（File）​​或​​输入流（InputStream）​

// 方式1：通过文件路径读取（自动关闭流）
ExcelReaderBuilder builder = EasyExcel.read("D:\\data\\user.xlsx");

// 方式2：通过输入流读取（需手动管理流生命周期）
InputStream inputStream = new FileInputStream("D:\\data\\user.xlsx");
ExcelReaderBuilder builder = EasyExcel.read(inputStream);

2. 配置读取参数

通过 ExcelReaderBuilder配置读取细节，常见参数包括：

​​sheet​​：指定读取的 Sheet（可传入​​索引（0 开始）​​、​​名称（如"Sheet1"）​​或直接调用 sheet()默认读取第一个 Sheet）；•

​​headRowNumber​​：指定表头所在行（默认 0，即第一行为表头）；

​​autoCloseStream​​：是否自动关闭输入流（默认 true，避免资源泄漏）；

​​excelType​​：指定