核心内容摘要
小乔翻白眼流口水流眼泪：揭秘三国第一美人背后的“表情包”时刻
还记得刚入行时一听到 Excel 导出 就条件反射地冒冷汗 ——POI 那套 API 跟迷宫似的CellStyle 能把人调得眼冒金星大数据量导出时内存飙到 90% 的恐惧至今难忘。
直到去年被产品经理逼到墙角时发现了 Alibaba 的 EasyExcel从此打开新世界的大门。
今天就把这套 导出救命锦囊 分享给大家顺便穿插点当年踩坑的段子让咱们在笑声中搞定 Excel 导出。
01先给项目把 EasyExcel 的 脉—— 环境整合篇
引入依赖别让 Maven 耍小脾气首先在pom.xml里加依赖这里得注意版本兼容性。
我曾试过用最新版 EasyExcel 配老 Spring Boot结果像小孩打架似的报错不断。
建议直接抄作业dependency groupIdcom.alibaba/groupId artifactIdeasyexcel/artifactId version
3.
2/version /dependency dependency groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-web/artifactId /dependency加完记得刷新 Maven这玩意儿有时候像闹情绪的女朋友得哄着来。
创建实体类给数据贴 xxx咱得先定义 Excel 里每一列的数据结构就像给每个字段发一张 座位牌。
比如导出用户信息Data public class UserExcelVO { // 这里是表头名称宽度设置成20就像给单元格定制合适的衣服尺码 ExcelProperty(value 用户ID, index
private Long userId; // 用转换器把日期变成yyyy-MM-dd格式不然Excel会显示成奇怪的数字 ExcelProperty(value 注册时间, index
DateTimeFormat(yyyy-MM-dd) private Date registerTime; // 自定义转换器把性别0/1转成男女不然产品经理会追着你改需求 ExcelProperty(value 性别, index
Converter(SexConverter.class) private Integer sex; }这里的ExcelProperty就像给数据贴标签index是列顺序可别标错号不然数据错位时你会怀疑人生 —— 我曾把金额和年龄的位置搞反被财务小姐姐骂得狗血淋头。
编写导出工具类把重复工作打包成 瑞士军刀把通用导出逻辑封装起来以后每次导出就像拧瓶盖一样简单。
创建EasyExcelUtilspublic class EasyExcelUtils { public static T void exportExcel(HttpServletResponse response, ListT dataList, ClassT clazz, String fileName) throws IOException { response.setContentType(application/vnd.openxmlformats-officedocument.spreadsheetml.sheet); response.setCharacterEncoding(utf-
; // 文件名得处理中文不然下载下来是乱码别问我怎么知道的摸了摸头上的包 fileName URLEncoder.encode(fileName, UTF-
.replaceAll(\, %
; response.setHeader(Content-disposition, attachment;filename*utf-8 fileName .xlsx); // 这里用EasyExcel.write()就像启动一个Excel生成器简单到让我怀疑人生 EasyExcel.write(response.getOutputStream(), clazz) .sheet(数据报表) .doWrite(dataList); } }从此告别每次导出都写重复代码的日子就像有了自动咖啡机再也不用手动磨豆子了。
02实战演练从 普通导出 到 花里胡哨 的需求突围
基础导出先搞定 刚需在 Controller 里调用工具类就像把食材放进微波炉GetMapping(/exportUser) public void exportUser(HttpServletResponse response) throws IOException { ListUserExcelVO dataList userService.getUserListForExport(); // 假设这是从数据库查的数据 EasyExcelUtils.exportExcel(response, dataList, UserExcelVO.class, 用户信息表); }第一次跑通时我对着屏幕傻笑了三分钟 —— 七年了终于不用跟 POI 的 N 个参数较劲了
复杂表头当领导突然说 再加一层分类有时候表头需要多级结构比如 用户信息 下分 基本信息 联系方式 。
这时候需要用ExcelProperty的数组形式Data public class ComplexHeaderVO { ExcelProperty({用户信息, 用户ID}) private Long userId; ExcelProperty({用户信息, 姓名}) private String userName; ExcelProperty({联系方式, 手机号}) private String phone; ExcelProperty({联系方式, 邮箱}) private String email; }看着生成的两层表头突然想起当年被产品经理临时加需求的夜晚而现在EasyExcel 让我能优雅应对甚至想主动问还有什么花样爸爸接得住
合并单元格玩一把 Excel 拼图游戏比如导出报表时需要合并相同内容的单元格这时候得自定义CellWriteHandler。
举个例子合并连续相同的部门名称public class MergeCellHandler implements CellWriteHandler { Override public void afterCellDispose(CellWriteHandlerContext context) { // 这里省略具体实现核心是通过行号和列号判断是否合并 // 就像拼拼图找到相同的部分粘在一起 } }在导出时注册这个处理器EasyExcel.write(...) .registerWriteHandler(new MergeCellHandler()) .doWrite(...);第一次实现合并单元格时我兴奋地在工位上哼起了《爱拼才会赢》毕竟以前用 POI 写合并代码能写满两屏现在轻松多了。
自定义格式让数据 穿上漂亮衣服比如金额需要显示成 ¥1,
0
00日期要显示成 2025 年 5 月 29 日。
除了前面提到的DateTimeFormat数值格式可以用NumberFormatExcelProperty(金额) NumberFormat(#,##
0.
private Double amount;看着导出的规范格式突然想起当年因为金额格式不对被财务打回 13 次的惨案现在终于能扬眉吐气了。
大数据量导出别让内存 撑破肚皮当数据量超过 10 万条时直接导出会把内存撑爆这时候得用流式处理。
EasyExcel 贴心地支持分页导出每次查 1000 条分批次写入EasyExcel.write(response.getOutputStream(), UserExcelVO.class) .sheet(大数据报表) .registerWriteHandler(...) // 可选的样式处理器 .doWrite(new AnalysisContext() - { // 这里每次调用获取一页数据直到没有数据为止 ListUserExcelVO pageData userService.getPageData(analysisContext.readRowHolder().getRowIndex()); return pageData; });记得当年用 POI 导出 20 万条数据服务器直接内存溢出被运维大哥拎着键盘来问罪现在有了流式处理再也不怕大数据量了。
03避坑指南这些 暗礁 别踩
依赖冲突当 Maven 开始 闹别扭如果引入了旧版 POI 依赖可能会和 EasyExcel 的 POI 版本冲突。
这时候别慌用mvn dependency:tree命令排查然后在pom.xml里用排除冲突项就像哄孩子一样把捣乱的依赖赶走。
注解优先级别让 标签 打架ExcelProperty可以写在字段上或方法上建议统一写在字段上不然容易混乱。
我曾在一个类里混合使用结果导出时字段顺序乱成一锅粥debug 了两小时才发现问题。
样式设置别把 Excel 变成 花脸猫虽然 EasyExcel 支持自定义样式但别过度使用比如给每个单元格设置不同颜色导出的 Excel 可能打不开。
样式设置要适度就像化妆自然美才是真的美。
04
总结从 被 Excel 支配 到 掌控导出自由折腾了七年 Excel 导出从 POI 的磕磕绊绊到 EasyExcel 的丝滑体验不得不感叹开源工具的伟大。
现在每次接到导出需求我都能淡定地说放马过来吧不管是复杂表头、大数据量还是格式要求咱这工具都能搞定。
最后送大家一句口诀EasyExcel 真的妙注解一标数据跳工具类里封装好导出从此没烦恼。
复杂需求别害怕处理器来把忙帮踩过的坑我来扛各位兄弟放心上如果你在整合过程中遇到什么奇怪的问题欢迎留言交流 —— 毕竟我这七年攒了一箩筐的导出故事咱们慢慢唠。
现在打开你的 IDE试试用 EasyExcel 导出第一份数据吧相信我你会爱上这种轻松的感觉