Easy Excel

WuWuII

已于 2025-06-09 20:49:02 修改

阅读量403

点赞数 5

CC 4.0 BY-SA版权

分类专栏： java 文章标签： excel java处理excel

于 2025-06-09 20:47:58 首次发布

本文链接：https://blog.csdn.net/a3562323/article/details/148118170

java 专栏收录该内容

64 篇文章

订阅专栏

Easy Excel

其它
- 自定义转换器没生效

Easy Excel在POI的基础上进行了优化。
EasyExcel 是阿里巴巴开源的 Java Excel 读写工具，相比 Apache POI 更加轻量和高效。它广泛用于大数据量的 Excel 导入导出场景，特别适合 Spring Boot 项目中使用。

下面是 EasyExcel 的常用使用方式和注解说明：

一、依赖引入

<dependency>
    <groupId>com.alibaba</groupId>
    <artifactId>easyexcel</artifactId>
    <version>3.3.2</version>
</dependency>

二、基本使用

1. 定义实体类（导入/导出共用）

import com.alibaba.excel.annotation.ExcelProperty;
import com.alibaba.excel.annotation.format.DateTimeFormat;
import com.alibaba.excel.annotation.write.style.ColumnWidth;
import lombok.Data;

import java.util.Date;

@Data
@ColumnWidth(20) // 设置列宽
public class UserExcel {

    @ExcelProperty("ID")
    private Long id;

    @ExcelProperty("用户名")
    private String username;

    @ExcelProperty("创建时间")
    @DateTimeFormat("yyyy-MM-dd HH:mm:ss")
    private Date createTime;
}

2. 写 Excel

List<UserExcel> dataList = ...;

String fileName = "用户信息.xlsx";
EasyExcel.write(fileName, UserExcel.class)
         .sheet("用户列表")
         .doWrite(dataList);

3. 读 Excel

public class UserExcelListener extends AnalysisEventListener<UserExcel> {

    @Override
    public void invoke(UserExcel data, AnalysisContext context) {
        System.out.println("读取到一条数据：" + data);
        // 可写入数据库或缓存等
    }

    @Override
    public void doAfterAllAnalysed(AnalysisContext context) {
        System.out.println("所有数据读取完毕");
    }
}

String fileName = "用户信息.xlsx";
EasyExcel.read(fileName, UserExcel.class, new UserExcelListener())
         .sheet()
         .doRead();

三、常用注解说明（完整列表）

注解	作用
`@ExcelProperty(value = "列名", index = 0)`	设置列名和顺序索引
`@DateTimeFormat("yyyy-MM-dd")`	格式化日期导出
`@NumberFormat("#.##")`	数字格式化导出
`@ExcelIgnore`	忽略该字段
`@ColumnWidth(20)`	设置导出列宽
`@ContentStyle(...)`	设置内容样式（字体、对齐、颜色）
`@HeadStyle(...)`	设置表头样式
`@ExcelIgnoreUnannotated`	类上标注，未标注 `@ExcelProperty` 的字段不导出
`@ExcelImage`	导出图片
`@ExcelEnum`（需额外扩展）	枚举值转中文等映射（通常结合 Converter 使用）

四、进阶：自定义转换器（Converter）

如：将性别枚举类型转换为字符串
GenderConverter是一个自定义的转换器，结合@ExcelProperty(value = "性别", converter = GenderConverter.class)中converter属性，跳转到GenderConverter处理值

public class GenderConverter implements Converter<GenderEnum> {

    @Override
    public Class<GenderEnum> supportJavaTypeKey() {
        return GenderEnum.class;
    }

    @Override
    public CellDataTypeEnum supportExcelTypeKey() {
        return CellDataTypeEnum.STRING;
    }

    @Override
    public CellData<String> convertToExcelData(GenderEnum value, ExcelContentProperty contentProperty, GlobalConfiguration globalConfiguration) {
        return new CellData<>(value.getDesc());
    }

    @Override
    public GenderEnum convertToJavaData(CellData cellData, ExcelContentProperty contentProperty, GlobalConfiguration globalConfiguration) {
        return GenderEnum.fromDesc(cellData.getStringValue());
    }
}

然后在实体类中使用：

@ExcelProperty(value = "性别", converter = GenderConverter.class)
private GenderEnum gender;

其它

自定义转换器没生效

要用converter指定
@ExcelProperty(value = “性别”, converter = GenderConverter.class)