在日常開(kāi)發(fā)中，Excel 文件的讀寫操作是一個(gè)常見(jiàn)的需求。EasyExcel 是阿里巴巴開(kāi)源的一個(gè)高性能、易用的 Excel 讀寫庫(kù)，可以大幅提高處理 Excel 文件的效率。它通過(guò)事件驅(qū)動(dòng)模型優(yōu)化了大數(shù)據(jù)量 Excel 的讀寫性能，非常適合處理大文件或高并發(fā)場(chǎng)景。

本篇博客將從 EasyExcel 的基本概念、優(yōu)勢(shì)、安裝、讀寫操作以及高級(jí)用法展開(kāi)，并提供清晰的代碼示例。

---

一、EasyExcel 的核心特點(diǎn)

1. 高性能：基于流式解析，低內(nèi)存消耗，適合大數(shù)據(jù)量操作。
2. 簡(jiǎn)單易用：提供了強(qiáng)大的注解支持，配置簡(jiǎn)單。
3. 兼容性強(qiáng)：支持 Excel 2007（.xlsx）及更高版本。
4. 事件驅(qū)動(dòng)模型：按需讀取，避免一次性加載所有數(shù)據(jù)到內(nèi)存。
5. 支持復(fù)雜表頭：可以輕松處理多級(jí)表頭、合并單元格等復(fù)雜場(chǎng)景。

---

二、安裝 EasyExcel

首先，在你的 Maven 項(xiàng)目中引入 EasyExcel 的依賴：

<dependency><groupId>com.alibaba</groupId><artifactId>easyexcel</artifactId><version>4.0.3</version> <!-- 請(qǐng)使用最新版本 -->
</dependency>

---

三、基本用法

1. 寫入 Excel

以下是一個(gè)簡(jiǎn)單的 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";// 準(zhǔn)備數(shù)據(jù)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;}// 數(shù)據(jù)類，使用注解指定表頭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;// 構(gòu)造函數(shù)、Getter 和 Setterpublic UserData(Integer id, String name, String email) {this.id = id;this.name = name;this.email = email;}}
}

說(shuō)明：

• @ExcelProperty 注解用于指定 Excel 列的標(biāo)題。
• EasyExcel.write() 是寫操作的入口，指定文件路徑和數(shù)據(jù)模型。

運(yùn)行以上代碼后，會(huì)生成一個(gè)名為 example.xlsx 的文件，包含一張標(biāo)題為“用戶信息”的表單。

---

2. 讀取 Excel

以下示例展示如何讀取 Excel 文件內(nèi)容：

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();}// 自定義監(jiān)聽(tīng)器，處理每一行數(shù)據(jù)public static class UserDataListener implements ReadListener<UserData> {@Overridepublic void invoke(UserData data, AnalysisContext context) {System.out.println("讀取到數(shù)據(jù)：" + data);}@Overridepublic void doAfterAllAnalysed(AnalysisContext context) {System.out.println("所有數(shù)據(jù)讀取完畢");}}
}

---

四、高級(jí)功能

1. 多級(jí)表頭

EasyExcel 支持復(fù)雜的多級(jí)表頭：

java

復(fù)制代碼

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({"聯(lián)系方式", "郵箱"})private String email;
}

在寫入時(shí)，會(huì)生成兩級(jí)表頭，分為“用戶信息”和“聯(lián)系方式”。

---

2. 大數(shù)據(jù)量讀取

針對(duì)大文件，EasyExcel 提供了分批讀取的能力。

EasyExcel.read(fileName, UserData.class, new ReadListener<UserData>() {@Overridepublic void invoke(UserData data, AnalysisContext context) {// 處理每一條數(shù)據(jù)}@Overridepublic void doAfterAllAnalysed(AnalysisContext context) {// 處理完成后執(zhí)行}
}).sheet().doRead();

通過(guò)監(jiān)聽(tīng)器，每次讀取一小部分?jǐn)?shù)據(jù)處理，避免內(nèi)存溢出。

---

五、使用場(chǎng)景

1. 導(dǎo)出數(shù)據(jù)報(bào)表：支持復(fù)雜的表格格式和多級(jí)表頭，可以生成格式化的報(bào)表文件。
2. 批量導(dǎo)入：支持從 Excel 導(dǎo)入數(shù)據(jù)到數(shù)據(jù)庫(kù)，處理高并發(fā)上傳。
3. 日志分析：處理大文件日志的導(dǎo)入和分析。

---

六、常見(jiàn)問(wèn)題

1. 內(nèi)存溢出：對(duì)于大數(shù)據(jù)量，建議使用分批讀取，避免一次性加載過(guò)多數(shù)據(jù)。
2. 日期格式問(wèn)題：使用 @ExcelProperty 的 converter 屬性自定義日期格式。
3. 合并單元格：需要自定義攔截器，控制單元格的樣式和合并行為。

---

七、總結(jié)

EasyExcel 是一個(gè)功能強(qiáng)大且高效的 Excel 操作工具。它通過(guò)簡(jiǎn)化代碼結(jié)構(gòu)、優(yōu)化性能和豐富的功能支持，成為 Java 開(kāi)發(fā)者處理 Excel 文件的首選庫(kù)。通過(guò)本篇博客的講解，相信你已經(jīng)掌握了 EasyExcel 的基本用法和高級(jí)功能，能夠在實(shí)際項(xiàng)目中高效處理 Excel 文件。

如果你喜歡這篇文章，請(qǐng)點(diǎn)贊、收藏或分享給更多需要的小伙伴吧！