Java使用FastExcel高效讀取和寫入Excel

更新時間：2025年11月05日 10:24:53 作者：智_永無止境

FastExcel 是一個 Java 庫,旨在高效地讀取和寫入 Excel 文件,它最初是 EasyExcel 的分叉版本,旨在提供增強的性能、持續(xù)維護和新功能,同時保持與原始 EasyExcel API 的兼容性,本文給大家介紹了Java如何使用FastExcel高效讀取和寫入Excel,需要的朋友可以參考下

01 引言

FastExcel大家可能不熟悉，但是EasyExcel應該都使用過吧？

FastExcel是EasyExcel版本的延續(xù)，自從阿里巴巴官方停止維護EasyExcel，EasyExcel的作者繼續(xù)維護起來，并持續(xù)改進優(yōu)化，并更名為FastExcel。

02 簡介

FastExcel 是一個 Java 庫，旨在高效地讀取和寫入 Excel 文件。它最初是 EasyExcel 的分叉版本，旨在提供增強的性能、持續(xù)維護和新功能，同時保持與原始 EasyExcel API 的兼容性。這使其成為在 Java 應用程序中處理 Excel 數據的強大的用戶友好的工具。

FastExcel 通過優(yōu)化內存使用來優(yōu)先考慮高性能，特別是在處理大型數據集時。它通過 SAX 解析機制實現這一點，以流式方式處理基于 XML 的 Excel 文件（XLSX），而無需一次性將整個文件加載到內存中。

官網地址：https://readmex.com/fast-excel/fastexcel/page-151366ada-2ea3-4451-aa3d-98ac90ce4f6e

Github地址：https://github.com/fast-excel/fastexcel

主要特性：

高性能讀寫：FastExcel 專注于性能優(yōu)化，能夠高效處理大規(guī)模的 Excel 數據。相比一些傳統(tǒng)的 Excel 處理庫，它能顯著降低內存占用。
簡單易用：該庫提供了簡潔直觀的 API，使得開發(fā)者可以輕松集成到項目中，無論是簡單的 Excel 操作還是復雜的數據處理都能快速上手。
流式操作：FastExcel 支持流式讀取，將一次性加載大量數據的問題降到最低。這種設計方式在處理數十萬甚至上百萬行的數據時尤為重要。

03 功能概要

業(yè)務項目中，我們經常需要讀寫Excel，如Excel的導入，導出。

3.1 Maven

<dependency>
    <groupId>cn.idev.excel</groupId>
    <artifactId>fastexcel</artifactId>
    <version>1.2.0</version> <!-- Or the latest version -->
</dependency>

3.2 模型類

用來接收Excel數據的實體

@Data
public class Book {

    private String bookName;
    private String author;
    private BigDecimal price;
    private Date saleDate;
}

3.3 讀取Excel文件

API：

案例：

@Test
void test01() throws FileNotFoundException {
    File file = ResourceUtils.getFile("classpath:file/demo.xls");
    List<Book> bookList = new ArrayList<>();
    FastExcel.read(file, Book.class, new ReadListener<Book>() {
        @Override
        public void invoke(Book book, AnalysisContext analysisContext) {
            System.out.println("解析數據:" + JSON.toJSONString(book));
            bookList.add(book);
        }

        @Override
        public void doAfterAllAnalysed(AnalysisContext analysisContext) {
            System.out.println("解析完所有數據....");
        }
    }).sheet().doRead();

    System.out.println("bookList:" + JSON.toJSONString(bookList));
}

執(zhí)行結果：

代碼解析：

read(File file, Class head, ReadListener readListener)

FastExcel擁有靜態(tài)方法read()
file：需要讀取的文件
head：需要將文件解析的對象，按照字段的順序和excel的澍勛解析，也可以通過@ExcelProperty指定索引位置
readListener：讀取每一條數據的監(jiān)聽器，處理數據也是這里處理的

FastExcel.read(...).sheet().doRead()

sheet()：默認第一個sheet，也可以傳遞參數指定
doRead()：開始同步讀取數據，也可以異步讀取數據doReadSync()

3.4 寫入Excel文件

寫入文件之前，我們需要定義模板類的名稱，需要使用到@ExcelProperty

@Data
public class Book {

    @ExcelProperty(value = "書名")
    private String bookName;
    @ExcelProperty(value = "作者")
    private String author;
    @ExcelProperty(value = "價格")
    @NumberFormat("#,###.00")
    private BigDecimal price;
    @ExcelProperty(value = "上架時間")
    @DateTimeFormat("yyyy-MM-dd")
    private Date saleDate;
}

API：

案例：

@Test
void test02() {
    List<Book> bookList = new ArrayList<>();
    for (int i = 0; i < 5; i++) {
        Book item = new Book();
        item.setBookName("Java" + i);
        item.setAuthor("張三" + i);
        item.setPrice(new BigDecimal("2002.35"));
        item.setSaleDate(new Date());
        bookList.add(item);
    }
    FastExcel.write("writeDemo.xls", Book.class).sheet().sheetName("test").doWrite(bookList);
}

執(zhí)行結果：