ARTICLE · 1366785
Java 导出 Excel 别再手搓了,JXLS 确实省事!
Java 项目里,导出 Excel 这件事看起来不复杂,真正做过几个业务就知道,麻烦的从来不是把数据写进单元格,而是模板。
比如一张订单报表,表头要合并,金额要设置格式,明细要循环填充,最后还要按部门分组统计。用 Apache POI 当然能做,但代码写着写着就容易变成这样:创建单元格、设置样式、合并区域、计算行号、复制格式……
需求再改两次,导出代码就很难看了。
这种场景,我更愿意用 JXLS。让 Excel 模板负责排版,让 Java 负责准备数据,别把两件事搅在一起。
一、JXLS 到底好用在哪?
JXLS 是一个基于 Excel 模板生成 Excel 文件的 Java 工具。
它底层依赖 Apache POI 处理 Excel 文件,但它的思路不一样:我们先在 Excel 里把报表样式设计好,再通过特殊标记告诉 JXLS 哪些地方需要循环、哪些地方需要填充数据。
假设现在要导出一份订单明细,包含订单编号、客户名称、商品数量和订单金额。
如果用 POI 从零创建,表头、列宽、字体、边框、金额格式都得用代码设置。JXLS 则可以直接使用现成的 Excel 模板,后续产品经理说表头要加个 logo,或者金额列要改成两位小数,通常直接改模板就够了。
这才是它真正省事的地方。
二、先准备一个 Excel 模板
先在项目的 src/main/resources/templates 目录下创建 order-report.xlsx。
模板第一行可以写报表标题,第二行写表头,第三行开始放明细。
在明细区域中,使用 JXLS 的表达式填充数据,并用 jx:each 标记告诉它需要循环哪些行。
例如,在明细行中设置以下内容:
订单编号:${item.orderNo}
客户名称:${item.customerName}
商品数量:${item.quantity}
订单金额:${item.amount}
然后给明细所在的行添加批注,配置循环指令:
jx:each(items="orders" var="item"
lastCell="D3")
这里的 orders 对应 Java 传入的数据集合,item 是每次循环使用的变量,lastCell 指定循环区域的右下角单元格。
注意,jx:each 是写在 Excel 模板批注中的指令,不是直接写到单元格里当普通文本使用。具体模板语法要和所使用的 JXLS 版本对应。
模板准备好后,后面就不用再手动计算每条订单应该落在哪一行了。
三、Java 代码怎么写?
先引入 JXLS 依赖。下面以 Maven 项目为例,版本号建议结合项目的 JDK 版本和依赖管理统一确定。
<dependency>
<groupId>org.jxls</groupId>
<artifactId>jxls</artifactId>
<version>${jxls.version}</version>
</dependency>
<dependency>
<groupId>org.jxls</groupId>
<artifactId>jxls-poi</artifactId>
<version>${jxls.version}</version>
</dependency>
业务代码负责查询订单、组装数据,然后把数据交给模板引擎。
下面这段代码按常见的 JXLS 模板处理方式编写,重点是把数据准备和 Excel 渲染分开:
import org.jxls.common.Context;
import org.jxls.util.JxlsHelper;
import java.io.InputStream;
import java.io.OutputStream;
import java.nio.file.Files;
import java.nio.file.Path;
import java.util.List;
public class OrderExcelExporter {
public void export(List<OrderRow> orders, Path target)
throws Exception {
if (orders == null || orders.isEmpty()) {
throw new IllegalArgumentException("没有可导出的订单数据");
}
Path parent = target.getParent();
if (parent != null) {
Files.createDirectories(parent);
}
try (InputStream template = getClass()
.getResourceAsStream(
"/templates/order-report.xlsx");
OutputStream output = Files.newOutputStream(target)) {
if (template == null) {
throw new IllegalStateException("Excel模板不存在");
}
Context context = new Context();
context.putVar("orders", orders);
JxlsHelper.getInstance()
.processTemplate(template, output, context);
}
}
}
这里有几个细节值得注意。
第一,context.putVar("orders", orders) 中的变量名必须和模板循环指令里的 items="orders" 一致。名字对不上,模板自然拿不到数据。
第二,OrderRow 应该是业务专用的导出对象,里面放 orderNo、customerName、quantity、amount 等字段。不要为了导出直接把数据库实体扔进模板,实体字段一多,模板也容易跟着业务表结构一起变化。
第三,文件流用完及时关闭。模板路径不存在、目标目录没有创建、数据为空,这些情况最好在导出入口就处理好,别等到线上下载接口才发现问题。
四、真正容易踩坑的是这几个地方
JXLS 不是把 POI 的问题全部消灭了,它只是把很多 Excel 排版工作从 Java 代码里挪到了模板中。
模板表达式写错,数据就出不来。 比如 Java 对象字段叫 customerName,模板却写成 ${item.customer},这类问题要优先检查变量名和对象属性。
金额格式不要只在 Java 中处理。 金额建议使用 BigDecimal,Excel 单元格格式则在模板中设置为金额格式。不要为了显示两位小数,就把金额提前转成字符串,否则后续求和、排序时可能出现麻烦。
模板复杂时,先拿少量数据验证。 合并单元格、动态行、公式、图片和复杂样式都可能影响最终效果。特别是模板中有公式时,要确认导出后公式是否正确,以及打开文件的客户端是否会重新计算。
还有一个问题:大批量导出。
如果一次导出几十万条数据,不要只盯着模板处理速度。数据库查询一次性加载全部记录、Java 堆内存占用、最终文件大小,都可能成为瓶颈。可以先分页查询,控制数据量;数据规模特别大时,再评估流式生成或拆分多个工作表。具体方案要看所用 JXLS 版本及其底层 POI 处理方式,别默认换个工具就能解决内存问题。
五、什么时候值得用 JXLS?
如果只是导出几列简单数据,POI 直接写入也没什么问题,没必要为了用工具而用工具。
但如果项目里有大量固定格式的业务报表,比如订单清单、财务报表、库存统计、生产记录,尤其是业务人员经常要求调整 Excel 样式,那么 JXLS 的价值就比较明显了。
模板交给熟悉 Excel 的人维护,Java 代码只负责查询和组装数据。报表样式变了,不一定需要重新发版;业务字段变了,也不必把所有单元格操作代码翻出来逐行修改。
我选导出工具时,比较在意的不是第一次写起来有多快,而是半年以后需求变了,这段代码还好不好维护。
Excel 模板能解决的问题,就别全塞进 Java 代码里。














































































