https://github.com/fast-excel/fastexcel
easyexcel作者最新升级版本， 快速、简洁、解决大文件内存溢出的java处理Excel工具
https://github.com/fast-excel/fastexcel
Last synced: 7 days ago
JSON representation
easyexcel作者最新升级版本， 快速、简洁、解决大文件内存溢出的java处理Excel工具
- Host: GitHub
- URL: https://github.com/fast-excel/fastexcel
- Owner: fast-excel
- License: apache-2.0
- Created: 2024-10-05T11:42:50.000Z (7 months ago)
- Default Branch: main
- Last Pushed: 2025-04-22T12:21:57.000Z (13 days ago)
- Last Synced: 2025-04-22T13:25:33.722Z (13 days ago)
- Language: Java
- Homepage: https://idev.cn/fastexcel
- Size: 22.9 MB
- Stars: 4,425
- Watchers: 71
- Forks: 338
- Open Issues: 100
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Codeowners: CODEOWNERS
Awesome Lists containing this project
- awesome-hacking-lists - fast-excel/fastexcel - easyexcel作者最新升级版本， 快速、简洁、解决大文件内存溢出的java处理Excel工具 (Java)
README
[中文](README.md) |[English](README_EN.md) | [日本語](README_JP.md)
## 什么是 FastExcel
FastExcel 是由原 EasyExcel 作者创建的新项目。2023 年我已从阿里离职，近期阿里宣布停止更新 EasyExcel，我决定继续维护和升级这个项目。在重新开始时，我选择为它起名为 FastExcel，以突出这个框架在处理 Excel 文件时的高性能表现，而不仅仅是简单易用。
FastExcel 将始终坚持免费开源，并采用商业友好的 Apache 协议，使其适用于任何商业化场景。这为开发者和企业提供了极大的自由度和灵活性。FastExcel 的一些显著特点包括：
- 1、完全兼容原 EasyExcel 的所有功能和特性，这使得用户可以无缝过渡。
- 2、从 EasyExcel 迁移到 FastExcel 只需简单地更换包名和 Maven 依赖即可完成升级。
- 3、在功能上，比 EasyExcel 提供更多创新和改进。
- 4、FastExcel 1.0.0 版本新增了读取 Excel 指定行数和将 Excel 转换为 PDF 的功能。
我们计划在未来推出更多新特性，以不断提升用户体验和工具实用性。欢迎大家关注 程序员小懒的公众号 关注FastExcel的发展。FastExcel 致力于成为您处理 Excel 文件的最佳选择。
## 主要特性
- 1. 高性能读写：FastExcel 专注于性能优化，能够高效处理大规模的 Excel 数据。相比一些传统的 Excel 处理库，它能显著降低内存占用。
- 2. 简单易用：该库提供了简洁直观的 API，使得开发者可以轻松集成到项目中，无论是简单的 Excel 操作还是复杂的数据处理都能快速上手。
- 3. 流式操作：FastExcel 支持流式读取，将一次性加载大量数据的问题降到最低。这种设计方式在处理数十万甚至上百万行的数据时尤为重要。
## 安装
下表列出了各版本 FastExcel 基础库对 Java 语言版本最低要求的情况：
| 版本 | jdk版本支持范围 | 备注 |
|--------|:---------------:|----------------------------------|
| 1.0.0+ | jdk8 - jdk21 | 目前的master分支，完全兼容easyexcel |
我们强烈建议您使用最新版本的 FastExcel，因为最新版本中的性能优化、BUG修复和新功能都会让您的使用更加方便。
> 当前 FastExcel 底层使用 poi 作为基础包，如果您的项目中已经有 poi 相关组件，需要您手动排除 poi 的相关 jar 包。
## 更新
您可以在 [版本升级详情](CHANGELOG.md) 中查询到具体的版本更新细节。 您也可以在[Maven 中心仓库](https://mvnrepository.com/artifact/cn.idev.excel/fastexcel)中查询到所有的版本。
### Maven
如果您使用 Maven 进行项目构建，请在 `pom.xml` 文件中引入以下配置：
```xml
cn.idev.excel
fastexcel
1.2.0
```
### Gradle
如果您使用 Gradle 进行项目构建，请在 `build.gradle` 文件中引入以下配置：
```gradle
dependencies {
implementation 'cn.idev.excel:fastexcel:1.2.0'
}
```
## EasyExcel 与 FastExcel 的区别
- 1. FastExcel 支持所有 EasyExcel 的功能，但是 FastExcel 的性能更好，更稳定。
- 2. FastExcel 与 EasyExcel 的 API 完全一致，可以无缝切换。
- 3. FastExcel 会持续的更新，修复 bug，优化性能，增加新功能。
## EasyExcel 如何升级到 FastExcel
### 1. 修改依赖
将 EasyExcel 的依赖替换为 FastExcel 的依赖，如下：
```xml
com.alibaba
easyexcel
xxxx
```
的依赖替换为
```xml
cn.idev.excel
fastexcel
1.2.0
```
### 2. 修改代码
将 EasyExcel 的包名替换为 FastExcel 的包名，如下：
```java
// 将 easyexcel 的包名替换为 FastExcel 的包名
import com.alibaba.excel.*;
```
替换为
```java
import cn.idev.excel.*;
```
### 3. 不修改代码直接依赖 FastExcel
如果由于种种原因您不想修改代码，可以直接依赖 FastExcel ，然后在 `pom.xml` 文件中直接依赖 FastExcel。
EasyExcel 与 FastExcel 可以共存，但是长期建议替换为 FastExcel。
### 4. 建议以后使用 FastExcel 类
为了兼容性考虑保留了 EasyExcel 类，但是建议以后使用 FastExcel 类，FastExcel 类是FastExcel 的入口类，功能包含了 EasyExcel 类的所有功能，以后新特性仅在 FastExcel 类中添加。
## 简单示例：读取 Excel 文件
下面是读取 Excel 文档的例子：
```java
// 实现 ReadListener 接口，设置读取数据的操作
public class DemoDataListener implements ReadListener {
@Override
public void invoke(DemoData data, AnalysisContext context) {
System.out.println("解析到一条数据" + JSON.toJSONString(data));
}
@Override
public void doAfterAllAnalysed(AnalysisContext context) {
System.out.println("所有数据解析完成！");
}
}
public static void main(String[] args) {
String fileName = "demo.xlsx";
// 读取 Excel 文件
FastExcel.read(fileName, DemoData.class, new DemoDataListener()).sheet().doRead();
}
```
## 简单示例：创建 Excel 文件
下面是一个创建 Excel 文档的简单例子：
```java
// 示例数据类
public class DemoData {
@ExcelProperty("字符串标题")
private String string;
@ExcelProperty("日期标题")
private Date date;
@ExcelProperty("数字标题")
private Double doubleData;
@ExcelIgnore
private String ignore;
}
// 填充要写入的数据
private static List data() {
List list = new ArrayList<>();
for (int i = 0; i < 10; i++) {
DemoData data = new DemoData();
data.setString("字符串" + i);
data.setDate(new Date());
data.setDoubleData(0.56);
list.add(data);
}
return list;
}
public static void main(String[] args) {
String fileName = "demo.xlsx";
// 创建一个名为“模板”的 sheet 页，并写入数据
FastExcel.write(fileName, DemoData.class).sheet("模板").doWrite(data());
}
```
## 关注作者
关注作者“程序员小懒“的公众号加入技术交流群，获取更多技术干货和最新动态。
