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)