Java泛型实现Excel导入导出的核心是解耦数据模型与IO逻辑，通过@ExcelColumn注解标记字段映射关系，结合反射与POI封装类型安全、可复用的工具类，支持动态列、嵌套属性及错误收集。
Java 中用泛型实现通用 Excel 导入导出，核心是把数据模型与读写逻辑解耦，通过泛型约束类型安全，配合注解标记字段映射关系，再借助 Apache POI 封装可复用的工具类。不写重复代码，也不牺牲灵活性。
定义实体类并用注解标记 Excel 列
为字段添加自定义注解（如 @ExcelColumn），声明列名、顺序、是否忽略、日期格式等：
- 创建注解
@ExcelColumn(order = 0, name = "姓名", format = "yyyy-MM-dd") - 在实体类字段上使用，例如：
public class User {
@ExcelColumn(order = 0, name = "用户名")
private String username;
@ExcelColumn(order = 1, name = "注册时间", format = "yyyy/MM/dd HH:mm")
private LocalDateTime createTime;
} - 支持忽略字段（
@ExcelColumn(ignore = true)）或空值处理策略
泛型导出工具：根据 Class 自动提取列信息并写入
导出方法接收 List<t></t> 和 Class<t></t>，利用反射读取注解生成表头和行数据：
- 用
Class.getDeclaredFields()获取所有字段，按@ExcelColumn.order排序 - 调用
field.get(obj)取值，对LocalDateTime等类型按format格式化成字符串 - 封装为静态方法：
public staticvoid exportToExcel(List data, Class clazz, OutputStream out) - 支持多 sheet、自动列宽、中文表头居中加粗等基础样式（POI 的
CellStyle封装）
泛型导入工具：将 Excel 行映射为对象实例
导入时需处理类型转换、空值、格式校验、错误收集等，泛型保证返回 List<t></t> 类型安全：
立即学习“Java免费学习笔记（深入）”；
- 读取第一行确定列名，匹配
@ExcelColumn.name找到对应字段 - 逐行解析：用
SimpleDateFormat或DateTimeFormatter转日期；数字字段尝试Integer.valueOf()；布尔支持“是/否”、“true/false”等别名 - 异常不中断，记录行号 + 字段 + 错误原因（如“第5行【年龄】不是有效整数”），最后统一抛出自定义
ExcelImportException - 提供回调接口
Function<string t></string>支持自定义转换逻辑（如编码转名称）
进阶：支持嵌套属性与动态列
实际业务常有“部门名称”来自关联对象，或导出列由前端配置决定：
- 用 SpEL 表达式支持嵌套：如
@ExcelColumn(name = "部门", el = "dept.name")，运行时解析obj.getDept().getName() - 导出方法增加
List<excelcolumndefinition></excelcolumndefinition>参数，绕过注解，完全动态控制列名、字段路径、格式器 - 导入也支持按列索引绑定（避免依赖列名），适用于无表头或列顺序不确定的场景
