JXLS实战指南：从配置到避坑，高效实现Excel数据导入导出

1. 为什么我最终选择了JXLS来处理Excel？

在Java后端开发里，处理Excel的导入导出是个高频需求，也是个“脏活累活”。我最早用过Apache POI，功能确实强大，但写起来太繁琐了，一个简单的导出就得写几十行样板代码，格式调整更是噩梦。后来也试过EasyExcel，它在处理大数据量时性能不错，但模板功能相对简单，遇到复杂表头、多sheet、动态列这些场景，配置起来还是有点吃力。

直到我在一个数据报表项目中遇到了JXLS，才算找到了一个平衡点。JXLS的核心思想是**“模板驱动”**。你可以先用Excel（或者WPS）画好一个最终想要样子的模板，哪里放标题，哪里放表格，哪里要循环列表数据，都用它特定的标记语言在Excel单元格里写好。然后，你的Java代码只需要准备好数据，往模板里一“灌”，一个格式完美的Excel文件就生成了。导入也是同理，通过一个XML映射文件来定义Excel里的行列如何对应到Java对象的字段上。

这种方式的优势太明显了：开发效率高，维护成本低。产品经理或运营同学可以直接用Excel设计报表样式，开发只需要关注数据逻辑。样式调整再也不用重新编译部署代码了，改改模板文件就行。实测下来，对于绝大多数中小型企业的内部管理系统、数据报表、批量操作等场景，JXLS的“模板+数据”模式非常“稳”，能避开很多直接用POI编码时容易踩的坑。

2. 5分钟快速上手：你的第一个JXLS导出

光说不练假把式，我们直接来创建一个最简单的导出例子。假设我们要导出一个员工列表，包含姓名、部门和工资。

2.1 项目依赖配置

首先，在你的Maven项目的pom.xml里加入JXLS的核心依赖。这里注意，JXLS 2.x版本后，核心引擎和读写器是分开的。对于基础的导出功能，我们只需要jxls和jxls-poi（它底层使用了POI来处理Excel文件）。

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

如果你还需要用到导入功能（也就是XLSReader），那就需要额外引入jxls-reader。我建议一开始就都配上，避免后面要用的时候还得改配置。

<dependency>
    <groupId>org.jxls</groupId>
    <artifactId>jxls-reader</artifactId>
    <version>2.0.6</version>
</dependency>

2.2 制作第一个Excel模板

这是JXLS最精髓的一步。我们在项目的资源目录下（比如src/main/resources/templates）新建一个Excel文件，命名为employee_template.xls。注意，.xls和.xlsx格式都支持，但有些旧版本对.xlsx支持可能有细微差别，用.xls最稳妥。

打开这个Excel文件，像平时一样设计表头：

等等，这样写死的数据导出有什么用？别急，现在我们来注入“灵魂”。把A2到C2单元格（也就是数据开始的第一行）清空，然后在A2单元格里写上 ${employee.name}，B2单元格写 ${employee.department}，C2单元格写 ${employee.salary}。

这还不够，我们需要告诉JXLS：“这一行要循环，把每个员工对象都按这个格式填进来”。在A2单元格的批注里写上：jx:each(items="employees" var="employee" lastCell="C2")。这个批注的意思就是，循环遍历名为employees的集合，每个元素叫employee，循环体从当前单元格开始，到C2单元格结束。

提示：在Excel里插入批注的方法是：右键单元格 -> 插入批注。把上面的指令写进去就行，JXLS引擎在解析时会读取这些批注指令。

现在，你的模板就做好了。它看起来第一行是表头，第二行是带有特殊标记和批注的“样板行”。JXLS在处理时，会根据批注指令，复制这一行，并用集合里的每个employee对象的值替换掉${}里的变量。

2.3 编写导出代码

模板准备好了，接下来写Java代码就非常简单了。我们创建一个Employee实体类，然后写一个导出的方法。

// 1. 简单的员工实体类
public class Employee {
    private String name;