Java 导出 Excel 利器:JXLS,复杂报表不用再手搓单元格

Java 项目里导出 Excel，最麻烦的往往不是把数据写进去，而是格式。

比如一张订单报表，需要合并单元格、设置表头、循环填充明细、计算合计金额，还要根据订单状态显示不同颜色。用 Apache POI 从头开始写，光是创建单元格、设置样式、处理行列索引，就能写出一大堆代码。

更麻烦的是，产品经理改了个表头，原本的合并区域也得跟着调整。改着改着，导出代码比业务代码还长。

这种场景，我更愿意用 JXLS。

它的思路比较直接：Excel 模板负责排版，Java 负责准备数据，JXLS 负责把数据填进模板。 不需要每次都用 Java 代码重新搭建整张 Excel 表。

一、先准备 Excel 模板

假设现在要导出订单明细，包含订单号、客户名称、商品名称、数量和金额。

传统做法是 Java 创建工作簿，再一行一行创建单元格。JXLS 可以换一种方式：先在 Excel 中把表头、字体、边框、列宽都设置好，再通过表达式标记需要填充的位置。

例如，模板文件 order-report.xlsx 可以设计成这样：

这里需要注意，实际使用时，JXLS 的循环区域要通过模板命令正确标记。可以在 Excel 单元格中使用 JXLS 的批注命令，例如 jx:each，指定循环的数据集合、循环变量以及需要重复生成的区域。

模板配置好以后，后续调整表格样式、标题、边框，很多时候直接修改 Excel 文件就够了，不用重新编译 Java 代码。

二、Java 代码怎么写？

先引入 JXLS 依赖。下面以 JXLS 2.x 为例，使用 Maven 管理依赖，版本号根据项目实际情况选择。

<dependency>
<groupId>org.jxls</groupId>
<artifactId>jxls</artifactId>
<version>2.14.0</version>
</dependency>

<dependency>
<groupId>org.jxls</groupId>
<artifactId>jxls-poi</artifactId>
<version>2.14.0</version>
</dependency>

接下来准备业务数据。假设项目中已经有订单明细对象 OrderLine，这里直接使用它承载导出数据。

publicclassOrderLine{
private String orderNo;
private String customerName;
private String productName;
private Integer quantity;
private BigDecimal amount;

// 构造方法、Getter 和 Setter 省略
}

导出时，不需要再去循环创建每个单元格。把数据放入上下文，再交给 JXLS 处理即可。

publicvoidexportOrderReport(
        List<OrderLine> orderLines,
        OutputStream outputStream)throws IOException {

    Map<String, Object> model = new HashMap<>();
    model.put("orderLines", orderLines);

try (InputStream template = getClass()
            .getResourceAsStream("/templates/order-report.xlsx")) {

if (template == null) {
thrownew FileNotFoundException("订单报表模板不存在");
        }

        Context context = new Context();
        context.putVar("orderLines", orderLines);

        JxlsHelper.getInstance().processTemplate(
                template, outputStream, context);
    }
}

上面这段代码只负责三件事：找到模板、准备数据、执行模板转换。

真正决定 Excel 最终长什么样的，是模板中的循环命令和单元格表达式。

例如，循环命令中的集合变量使用 orderLines，那么模板中的每一行就可以通过循环变量访问订单字段。模板命令、变量名和 Java 上下文必须对应上，否则就可能出现数据没有填充、表达式解析失败等问题。

还有一点别忽略：OutputStream 由调用方提供，这里不主动关闭它。假如外层是 Spring MVC 的响应流，随手关闭就可能影响后续响应处理。

三、JXLS 好用，但不是没有坑

JXLS 最适合的，是那些格式相对固定、数据区域需要动态扩展的 Excel 报表。

比如财务月报、订单明细、库存盘点表、销售统计表。表头和样式由模板维护，Java 只关心数据，这种职责划分比较清楚。

不过，模板不是随便画完就能用。

第一，循环区域要标对。 如果循环命令没有覆盖正确的明细区域，可能出现只填充一行、样式没有跟着复制，或者明细区域扩展异常的问题。

第二，金额类型不要随手转成字符串。 金额建议使用 BigDecimal，让 Excel 单元格保留数值类型。后续还要在 Excel 里求和、排序或者计算时，这一点尤其重要。金额格式可以直接在模板中设置。

第三，大数据量导出要提前考虑内存。 JXLS 配合 POI 处理模板时，并不意味着数据量再大也不会有性能问题。如果一次性查询几十万条数据，再把所有对象放进上下文，内存压力依然存在。需要结合数据量评估分页查询、分批处理或流式导出方案，不能只换一个框架就指望解决所有性能问题。

另外，模板文件最好纳入版本管理。生产环境出现导出异常时，除了看 Java 日志，也要确认部署的模板是不是最新版本，尤其是修改过批注命令、表达式和合并单元格之后。

四、什么时候选 JXLS，什么时候选 POI？

我的判断很简单。

如果导出的 Excel 是固定格式的业务报表，里面有标题、表头、明细循环、合计行，优先考虑 JXLS。模板交给熟悉 Excel 的人维护，Java 代码也能少掉不少重复操作。

如果你要动态创建大量工作表、精细控制单元格行为，或者实现复杂的 Excel 文件处理逻辑，Apache POI 直接操作可能更灵活。

JXLS 底层也离不开 POI，它并不是用来替代 POI 的所有能力，而是把常见的模板填充工作封装起来。

说到底，导出 Excel 最容易失控的地方，就是把格式、循环和业务计算全部塞进 Java 代码里。代码刚写出来时没什么问题，等到报表字段越来越多，维护成本就上来了。

固定格式用模板，变化的数据交给 Java。 这件事用 JXLS 做，通常比手动操作每一个单元格省心得多。