企业官网建设流程全解析

1. 项目概述：为什么选择Freemarker处理复杂Excel？

如果你也经常被“动态生成复杂Excel报表”这个需求搞得头大，比如要处理多层表头、合并单元格、条件格式，或者数据源来自多个对象和列表，那么今天聊的这个方案，可能会让你眼前一亮。传统用POI或EasyExcel硬编码的方式，一旦报表格式变动，代码就得大改，维护起来简直是噩梦。而使用Freemarker模板引擎来驱动Excel生成，其核心思想是将视图（Excel的样式与布局）与数据模型彻底分离。

简单来说，我们把最终要生成的Excel文件，预先用Office软件（如WPS或Microsoft Excel）设计好一个模板文件。这个模板不是普通的Excel，而是一个包含了Freemarker指令（如${name},<#list users as user>）的XML文件。程序运行时，我们只需要准备好数据（一个Map或Java对象），然后交给Freemarker引擎。引擎会像渲染HTML页面一样，将数据“灌入”模板中的占位符和循环逻辑里，最终输出一个完整的、格式正确的Excel文件（.xlsx格式）。这个过程，就相当于我们提前做好了一个有“空洞”的模具，生产时只需注入“数据原料”，瞬间就能得到一个成型的产品。

这种方法最大的优势在于灵活性和可维护性。产品经理或业务人员可以直接用他们熟悉的Excel来设计报表样式，开发人员只需关注数据准备和模板指令的编写。当报表格式需要调整时，绝大多数情况下只需修改模板文件，无需重新发布代码。尤其适合那些格式固定但数据动态、或者需要导出大量复杂格式报表的场景，比如财务报表、统计清单、数据看板等。

2. 核心原理：Freemarker如何与Excel模板协同工作？

要理解这套流程，我们需要拆解两个关键部分：Excel模板的本质，以及Freemarker的处理逻辑。

2.1 Excel文件（.xlsx）的实质与模板制作

一个.xlsx格式的Excel文件，本质上是一个ZIP压缩包。如果你将其后缀名改为.zip并解压，会发现里面包含了一系列XML文件和资源文件夹。其中，描述单元格数据、样式和结构的主要文件是xl/worksheets/sheet1.xml。Freemarker模板正是基于这个XML文件创建的。

制作模板的实操步骤：

1. 用Excel设计最终样式：首先，在Excel中完全按照你想要导出的最终效果，设计好表格。包括表头、表格线、字体颜色、单元格合并、数值格式（如会计格式、日期格式）等。甚至可以预先放入一些示例数据，方便查看效果。
2. 另存为XML文件：设计完成后，不要直接保存为.xlsx。点击“文件” -> “另存为”，在保存类型中选择“XML表格 (*.xml)”并保存。这个步骤会生成一个标准的XML文件，它包含了Excel的所有样式和数据信息。
3. 将XML转换为Freemarker模板：用文本编辑器（如VS Code、Notepad++）打开上一步保存的.xml文件。你会看到类似下面的结构：

   <worksheet ...> <sheetData> <row r="1"> <c r="A1" t="inlineStr"> <is><t>员工姓名</t></is> </c> <c r="B1"> <v>1001</v> </c> </row> </sheetData> </worksheet>

   现在，将其中需要动态填充的示例数据，替换成Freemarker的表达式或指令。例如，将“员工姓名”后面的示例数据“1001”替换为${employee.id}，或者将一整行重复的数据用<#list employeeList as emp> ... </#list>包裹起来。
4. 修改文件后缀：将这个编辑好的XML文件的后缀名从.xml改为.ftl（Freemarker Template的常用后缀），例如complex_report.ftl。至此，你的Excel模板就制作完成了。

注意：在修改XML时，务必小心不要破坏XML的标签结构。建议使用具有XML语法高亮和格式化的编辑器。另外，Excel中复杂的样式（如条件格式、数据验证）可能对应着其他XML文件（如styles.xml），在简单的模板中这些通常可以保留原样，Freemarker不会去动它们。

2.2 Freemarker的数据模型与渲染机制

在Java后端，我们的任务是构建一个数据模型（Data Model）。这个模型通常是一个Map<String, Object>，也可以是一个Configuration设置好的根对象。模型中的键（Key）就对应模板中的变量名。

一个典型的数据模型构建示例：

Map<String, Object> data = new HashMap<>(); // 简单变量 data.put("reportTitle", "2024年第一季度销售报表"); data.put("exportDate", new Date()); // 对象 Employee manager = new Employee("张三", "总监"); data.put("manager", manager); // 列表（用于循环） List<SaleRecord> records = saleService.getQuarterlyRecords(); data.put("saleRecords", records); // 嵌套结构 Map<String, Object> summary = new HashMap<>(); summary.put("totalAmount", 1500000); summary.put("growthRate", "15.5%"); data.put("summary", summary);

准备好数据和模板后，Freemarker引擎的工作流程如下：

1. 加载模板：引擎读取.ftl模板文件，解析其中的FTL指令。
2. 合并数据：引擎将数据模型中的数据，应用到对应的表达式和指令上。${reportTitle}会被替换为“2024年第一季度销售报表”；<#list saleRecords as record>会循环展开列表中的每一个SaleRecord对象。
3. 输出结果：引擎将处理后的、所有占位符都被替换为真实数据的内容输出。此时输出的仍然是一个符合Excel XML结构的文本内容。
4. 包装为Excel：我们将这个输出的字符串内容，写入到一个新的.xml文件中，然后再将这个文件压缩回.xlsx格式（或者直接将其作为ZIP流的一部分写入到.xlsx），浏览器就能将其识别为一个可下载的Excel文件。

关键点：Freemarker本身并不“认识”Excel，它只是在处理文本（XML）。正是因为我们提供的模板文本恰好是Excel能理解的XML格式，所以最终产物才是一个有效的Excel文件。这种“欺骗性”正是该方案巧妙且强大的地方。

3. 从零开始：搭建环境与准备第一个模板

理论说得再多，不如动手一试。我们来一步步实现一个简单的员工信息导出例子。

3.1 项目环境与依赖配置

假设你使用Maven管理项目，在pom.xml中添加Freemarker依赖即可。通常我们使用较新的稳定版本。

<dependency> <groupId>org.freemarker</groupId> <artifactId>freemarker</artifactId> <version>2.3.32</version> <!-- 建议使用最新稳定版 --> </dependency>

如果你需要处理ZIP压缩包（即最终生成.xlsx），Java自带的java.util.zip包就足够了，无需额外依赖。对于Web项目，你还需要相应的Web框架依赖（如Spring Boot），这里不再赘述。

3.2 制作第一个Freemarker Excel模板

我们目标是导出一个包含部门、姓名、工号、入职日期的简单表格。

1. 在Excel中设计：
   • A1单元格输入“部门”，B1输入“姓名”，C1输入“工号”，D1输入“入职日期”。
   • 从A2到D2，可以填入一些示例数据，如“技术部”、“李四”、“E1001”、“2023-05-10”。
   • 可以为第一行（表头）设置加粗、背景色等样式。
2. 另存为XML：将文件另存为employee_template.xml。
3. 编辑XML/FTL文件：
   • 用编辑器打开employee_template.xml。
   • 找到包含示例数据“技术部”、“李四”等的行对应的XML部分。它看起来会像：

     <row r="2"> <c r="A2"><v>技术部</v></c> <c r="B2"><v>李四</v></c> <c r="C2"><v>E1001</v></c> <c r="D2"><v>2023-05-10</v></c> </row>

   • 我们将这一整行替换为Freemarker的列表指令：

     <#list employees as emp> <row r="${emp_index + 2}"> <!-- emp_index是Freemarker列表循环的内置变量，从0开始 --> <c r="A${emp_index + 2}"><v>${emp.department!}</v></c> <c r="B${emp_index + 2}"><v>${emp.name!}</v></c> <c r="C${emp_index + 2}"><v>${emp.employeeId!}</v></c> <c r="D${emp_index + 2}"><v>${emp.entryDate?string('yyyy-MM-dd')}</v></c> </row> </#list>

   • 解释：
     • <#list employees as emp>：循环遍历数据模型中名为employees的列表。
     • ${emp_index + 2}：emp_index是循环索引，从0开始。因为我们的数据从第2行开始，所以行号需要+2。列号（A, B, C, D）也需要动态拼接。
     • ${emp.department!}：!是空值处理运算符，如果emp.department为null，这里会输出空字符串，避免报错。
     • ${emp.entryDate?string('yyyy-MM-dd')}：?string('...')是内建函数，用于格式化日期。
4. 保存为FTL：将文件重命名为employee_template.ftl，并放入项目的资源目录，如src/main/resources/templates/。

3.3 编写Java代码进行渲染与导出

核心工具类通常包含配置Freemarker、加载模板、处理数据、输出文件等步骤。

import freemarker.template.Configuration; import freemarker.template.Template; import freemarker.template.TemplateException; import java.io.*; import java.util.*; public class ExcelExporterWithFreemarker { private Configuration cfg; public ExcelExporterWithFreemarker() throws IOException { cfg = new Configuration(Configuration.VERSION_2_3_32); // 设置模板加载路径（这里指向classpath下的templates目录） cfg.setClassForTemplateLoading(this.getClass(), "/templates"); cfg.setDefaultEncoding("UTF-8"); // 其他配置（如日期格式本地化）可按需设置 cfg.setLocale(Locale.CHINA); } /** * 生成Excel文件字节流 * @param templateName 模板文件名（如 "employee_template.ftl"） * @param dataModel 数据模型 * @return 包含.xlsx文件内容的字节数组 */ public byte[] exportToExcelBytes(String templateName, Map<String, Object> dataModel) throws IOException, TemplateException { // 1. 获取模板 Template template = cfg.getTemplate(templateName); // 2. 创建StringWriter，用于接收渲染后的XML内容 StringWriter xmlWriter = new StringWriter(); template.process(dataModel, xmlWriter); xmlWriter.flush(); String filledXmlContent = xmlWriter.toString(); xmlWriter.close(); // 3. 关键步骤：将渲染后的XML包装成完整的.xlsx文件 // 一个.xlsx文件是一个zip包，里面必须包含特定的目录结构和文件。 // 最简单的方法是：准备一个“干净的”基础模板.xlsx文件，只替换其中的sheet.xml。 // 这里我们采用另一种常见方式：直接构建一个包含必要文件的zip流。 ByteArrayOutputStream outputStream = new ByteArrayOutputStream(); try (ZipOutputStream zipOut = new ZipOutputStream(outputStream)) { // 3.1 添加必须的根级关系文件 zipOut.putNextEntry(new ZipEntry("[Content_Types].xml")); zipOut.write(getContentTypesXml().getBytes()); zipOut.closeEntry(); // 3.2 添加工作簿关系文件（通常位于xl/_rels/workbook.xml.rels） zipOut.putNextEntry(new ZipEntry("xl/_rels/workbook.xml.rels")); zipOut.write(getWorkbookRelsXml().getBytes()); zipOut.closeEntry(); // 3.3 添加工作簿定义文件（xl/workbook.xml） zipOut.putNextEntry(new ZipEntry("xl/workbook.xml")); zipOut.write(getWorkbookXml().getBytes()); zipOut.closeEntry(); // 3.4 添加我们刚刚用Freemarker渲染好的工作表内容（xl/worksheets/sheet1.xml） zipOut.putNextEntry(new ZipEntry("xl/worksheets/sheet1.xml")); zipOut.write(filledXmlContent.getBytes()); // 核心：注入动态内容 zipOut.closeEntry(); // 3.5 添加样式文件（如果模板中有样式，需要从原模板.zip中提取并放入） zipOut.putNextEntry(new ZipEntry("xl/styles.xml")); zipOut.write(getStylesXmlFromTemplate().getBytes()); // 此方法需实现，从原模板提取 zipOut.closeEntry(); // ... 可能还需要添加sharedStrings.xml等，取决于模板复杂度 } return outputStream.toByteArray(); } // 以下是一些辅助方法，返回对应文件的静态内容。在实际项目中， // 这些内容可以从一个“基础模板”xlsx文件中解压后获取并缓存，这样最准确。 private String getContentTypesXml() { return "<?xml version=\"1.0\" encoding=\"UTF-8\" standalone=\"yes\"?>\n" + "<Types xmlns=\"http://schemas.openxmlformats.org/package/2006/content-types\">\n" + " <Default Extension=\"rels\" ContentType=\"application/vnd.openxmlformats-package.relationships+xml\"/>\n" + " <Default Extension=\"xml\" ContentType=\"application/xml\"/>\n" + " <Override PartName=\"/xl/workbook.xml\" ContentType=\"application/vnd.openxmlformats-officedocument.spreadsheetml.sheet.main+xml\"/>\n" + " <Override PartName=\"/xl/worksheets/sheet1.xml\" ContentType=\"application/vnd.openxmlformats-officedocument.spreadsheetml.worksheet+xml\"/>\n" + " <Override PartName=\"/xl/styles.xml\" ContentType=\"application/vnd.openxmlformats-officedocument.spreadsheetml.styles+xml\"/>\n" + "</Types>"; } // 实现getWorkbookRelsXml, getWorkbookXml, getStylesXmlFromTemplate等方法... // 为了简化示例，此处省略。实际应用中，建议使用POI等库辅助构建这些固定部分，或直接从一个空白模板解压获取。 }

调用示例：

public void exportEmployeeReport(HttpServletResponse response) throws IOException, TemplateException { ExcelExporterWithFreemarker exporter = new ExcelExporterWithFreemarker(); // 构建数据 Map<String, Object> data = new HashMap<>(); List<Employee> empList = new ArrayList<>(); empList.add(new Employee("技术部", "李四", "E1001", LocalDate.of(2023,5,10))); empList.add(new Employee("市场部", "王五", "E1002", LocalDate.of(2022,8,22))); data.put("employees", empList); // 生成Excel字节流 byte[] excelBytes = exporter.exportToExcelBytes("employee_template.ftl", data); // 通过HTTP响应输出 response.setContentType("application/vnd.openxmlformats-officedocument.spreadsheetml.sheet"); response.setHeader("Content-Disposition", "attachment; filename=\"员工列表.xlsx\""); response.setContentLength(excelBytes.length); try (OutputStream out = response.getOutputStream()) { out.write(excelBytes); out.flush(); } }

实操心得：直接手动构建ZIP流虽然直观，但容易出错，特别是处理复杂样式和多个工作表时。更稳健的做法是：准备一个“骨架”Excel文件。这个文件包含所有必要的样式、定义文件，但数据sheet（sheet1.xml）是空的或者只有表头。在导出时，先复制这个骨架文件到一个临时位置，然后用Freemarker渲染好的sheet1.xml内容替换其中的对应文件，最后将这个临时文件输出给用户。Apache POI库中的XSSFWorkbook可以很好地读写.xlsx的底层ZIP结构，结合Freemarker使用会更高效可靠。

4. 进阶技巧：处理复杂报表结构与数据

掌握了基础导出后，我们来看看如何应对更复杂的业务场景。

4.1 实现多层表头与单元格合并

多层表头和合并单元格是复杂报表的常态。这些样式必须在最初的Excel模板设计阶段就完成。Freemarker只负责填充数据，不负责创建样式。

操作步骤：

1. 在Excel中直接合并：比如，你需要一个跨A1到D1的标题“销售汇总表”，就在Excel里选中A1:D1，点击“合并后居中”。需要“个人信息”作为A2和A3的父表头，就合并A2:A3。
2. 设计数据填充区域：在合并好的单元格内，仍然可以写入Freemarker表达式，如${reportTitle}。对于子表头下的数据区域，正常设计你的循环结构。
3. 保存并编辑XML：另存为XML后，你会发现合并的单元格对应<mergeCells>标签和<c>标签上的mergeAcross或mergeDown属性。千万不要删除或修改这些合并属性，只需在合适的<c>标签内，将<v>标签中的内容替换为你的Freemarker变量即可。

模板示例片段：

<!-- 在sheetData外部，定义了合并单元格 --> <mergeCells count="2"> <mergeCell ref="A1:D1"/> <!-- 合并标题行 --> <mergeCell ref="A2:A3"/> <!-- 合并“部门”表头 --> </mergeCells> <sheetData> <row r="1"> <!-- 合并后的标题单元格，占用了A1到D1 --> <c r="A1" s="1" t="inlineStr"> <!-- s="1"引用了样式 --> <is><t>${reportTitle}</t></is> </c> <!-- B1, C1, D1 在XML中可能不存在，因为它们被合并了 --> </row> <row r="2"> <c r="A2" s="2"><v>部门</v></c> <!-- 合并的父表头 --> <c r="B2" s="3"><v>姓名</v></c> <c r="C2" s="3"><v>Q1销售额</v></c> <c r="D2" s="3"><v>Q2销售额</v></c> </row> <row r="3"> <!-- A3单元格因为合并，在sheetData中可能不存在 --> <c r="B3" s="4"><v>${emp.name}</v></c> <c r="C3" s="5"><v>${emp.q1Sales?c}</v></c> <c r="D3" s="5"><v>${emp.q2Sales?c}</v></c> </row> </sheetData>

注意：XML中合并单元格的表示方式可能因Excel版本略有不同。最保险的方法是，在模板中做好合并后，观察生成的XML中相关单元格的表示，确保你的Freemarker变量放在了正确的位置。

4.2 处理列表嵌套与条件判断

Freemarker的指令在XML模板中同样强大。

嵌套列表：比如，导出部门及部门下的员工。

<#list departments as dept> <row r="${dept_index + 1}"> <c r="A${dept_index + 1}"><v>${dept.name}</v></c> </row> <#list dept.employees as emp> <row r="${...计算行号...}"> <c r="B${...}"><v>${emp.name}</v></c> <c r="C${...}"><v>${emp.title}</v></c> </row> </#list> </#list>

行号的计算需要格外小心，通常需要在数据模型中预先计算好，或者使用Freemarker的<#assign>指令定义一个行号计数器。

条件判断：比如，根据销售额显示不同文本。

<c r="D${emp_index + 2}"> <v> <#if emp.sales gt 10000> 优秀 <#elseif emp.sales gt 5000> 达标 <#else> 待提升 </#if> </v> </c>

或者根据状态显示不同颜色（这需要预先在Excel中定义好不同的单元格样式，比如s="10"代表红色，s="11"代表绿色，然后在Freemarker中动态决定使用哪个样式）：

<c r="E${emp_index + 2}" s="<#if emp.status == '紧急'>10<#else>11</#if>"> <v>${emp.task}</v> </c>

4.3 数字、日期与空值的格式化处理

格式化是提升报表可读性的关键。

• 数字格式化：在Excel模板中直接设置单元格格式为“会计格式”、“百分比”等。Freemarker填充纯数字即可。如果需要在Freemarker中控制小数位，可以使用内建函数?string(‘0.##’)。
• 日期格式化：如前所述，使用${someDate?string(‘yyyy-MM-dd’)}。确保数据模型中的日期是java.util.Date或java.time（如LocalDateTime）类型，Freemarker能良好支持。
• 空值处理：始终使用!（空值处理运算符）或??（空值判断）来避免模板渲染因空指针而中断。${value!}表示如果value为null则输出空字符串。${value!‘默认值’}可以指定默认值。

5. 性能优化与生产环境实践

当数据量很大（数万行）时，直接使用StringWriter和全内存ZIP操作可能导致内存压力。以下是一些优化思路：

5.1 大文件导出与流式处理

核心思想是边渲染边写入ZIP流，避免在内存中组装完整的XML字符串。

1. 使用Template.process()的重载方法：Freemarker的Template.process方法可以将数据直接输出到Writer或OutputStream。我们可以将一个指向ZIP条目输出流的Writer传递给它。
2. 分步构建ZIP：
   • 打开一个到HttpServletResponse输出流的ZipOutputStream。
   • 先写入固定的ZIP条目（如[Content_Types].xml,xl/workbook.xml等）。
   • 当需要写入动态的sheet1.xml时，调用zipOut.putNextEntry()创建该条目。
   • 关键步骤：不通过StringWriter，而是直接创建一个OutputStreamWriter包裹这个ZipOutputStream（在当前位置），然后传给template.process(dataModel, writer)。
   • Freemarker会边渲染边将内容写入ZIP流中的这个条目。渲染完成后，关闭writer和当前ZIP条目。
   • 继续写入其他必要文件，最后关闭总ZIP流。

public void exportLargeExcelStreaming(HttpServletResponse response, Map<String, Object> dataModel) throws IOException, TemplateException { response.setContentType("application/vnd.openxmlformats-officedocument.spreadsheetml.sheet"); response.setHeader("Content-Disposition", "attachment; filename=\"large_report.xlsx\""); try (ZipOutputStream zipOut = new ZipOutputStream(response.getOutputStream())) { // 1. 写入固定文件 writeStaticEntries(zipOut); // 2. 开始写入动态的工作表 zipOut.putNextEntry(new ZipEntry("xl/worksheets/sheet1.xml")); Writer sheetWriter = new OutputStreamWriter(zipOut, StandardCharsets.UTF_8); // 注意编码 // 3. 流式渲染模板并直接写入ZIP流 Template template = cfg.getTemplate("large_template.ftl"); template.process(dataModel, sheetWriter); sheetWriter.flush(); // 确保所有内容写出 zipOut.closeEntry(); // 关闭当前ZIP条目 // 4. 写入其他固定文件（如styles.xml） writeRemainingStaticEntries(zipOut); } // 流自动关闭 }

这种方式能显著降低内存消耗，因为数据不会全部缓存在内存的String中。

5.2 模板管理、缓存与配置

• 模板集中管理：将所有的.ftl文件放在统一的资源目录下（如classpath:/templates/excel/），便于管理和查找。
• 启用模板缓存：Freemarker的Configuration默认会缓存已解析的模板，这对性能至关重要。在生产环境中，不要每次导出都创建新的Configuration实例。通常将其配置为Spring容器的单例Bean。

  @Configuration public class FreemarkerConfig { @Bean public Configuration freemarkerConfiguration() throws IOException { Configuration cfg = new Configuration(Configuration.VERSION_2_3_32); cfg.setClassForTemplateLoading(this.getClass(), "/templates/excel"); cfg.setDefaultEncoding("UTF-8"); cfg.setTemplateUpdateDelayMilliseconds(3600000); // 设置模板缓存1小时更新 // cfg.setCacheStorage(new StrongCacheStorage()); // 使用强引用缓存（默认） return cfg; } }

• 异常处理：务必妥善处理TemplateException和IOException。在Web场景下，应给用户返回友好的错误提示，并在后台记录详细的日志，包括数据模型快照和模板名称，便于排查。

5.3 与现有框架（如Spring Boot）集成

在Spring Boot项目中，集成更加简便。

1. 你可以直接注入上面配置好的ConfigurationBean。
2. 在Controller中，使用@GetMapping或@PostMapping映射导出接口。
3. 在接口方法中，准备数据模型，调用工具类生成字节流，并通过ResponseEntity或直接操作HttpServletResponse输出文件。

一个Spring Boot风格的Controller示例：

@RestController @RequestMapping("/api/report") public class ReportExportController { @Autowired private Configuration freemarkerConfiguration; @Autowired private EmployeeService employeeService; @GetMapping("/export/employees") public void exportEmployeeExcel(HttpServletResponse response) throws IOException { try { // 准备数据 Map<String, Object> data = new HashMap<>(); data.put("employees", employeeService.findAll()); data.put("exportTime", LocalDateTime.now()); // 获取模板 Template template = freemarkerConfiguration.getTemplate("employee_advanced.ftl"); // 设置响应头 response.setContentType("application/vnd.openxmlformats-officedocument.spreadsheetml.sheet"); response.setHeader("Content-Disposition", "attachment; filename=\"员工详单.xlsx\""); // 流式输出 try (ZipOutputStream zipOut = new ZipOutputStream(response.getOutputStream())) { // ... 写入静态ZIP条目 ... zipOut.putNextEntry(new ZipEntry("xl/worksheets/sheet1.xml")); Writer writer = new OutputStreamWriter(zipOut, StandardCharsets.UTF_8); template.process(data, writer); writer.flush(); zipOut.closeEntry(); // ... 写入其他静态条目 ... } } catch (TemplateException | IOException e) { log.error("导出Excel失败", e); response.sendError(HttpServletResponse.SC_INTERNAL_SERVER_ERROR, "报表生成失败"); } } }

6. 常见问题、排查技巧与方案对比

在实际开发中，你肯定会遇到各种“坑”。这里记录了一些典型问题和解决方法。

6.1 常见问题速查表

6.2 方案对比：Freemarker vs. 传统POI/EasyExcel

个人建议的选择策略：

• 如果你的报表是“文书型”的：格式极其复杂（多层表头、不规则合并、特定位置插入图片和段落），且格式相对固定，强烈推荐Freemarker模板方案。一次开发模板，终身受益。
• 如果你的需求是“数据导出”：主要是将数据库查询结果以表格形式导出，样式简单（最多加个表头颜色），但数据量可能非常大，EasyExcel是更优选择。
• 如果你需要对现有Excel文件进行解析、修改或创建高度动态的内容，那么Apache POI仍然是功能最全、控制力最强的工具。

6.3 一个实用的调试技巧

当模板渲染结果不符合预期时，不要急于在代码中Debug。可以尝试以下步骤：

1. 将数据模型输出为JSON：在Java代码中，使用Jackson等工具将你的dataModelMap转换成JSON字符串，并打印到日志或保存到文件。检查数据结构是否正确，字段名是否与模板中的变量名匹配。
2. 渲染为文本文件：修改你的导出代码，暂时不生成ZIP，而是将template.process()的结果直接写入一个.xml文本文件。用浏览器或专业的XML编辑器打开这个文件，直观地查看Freemarker填充后的完整XML内容，很容易发现标签不闭合、变量未替换等问题。
3. 对比“正确”的XML：用一个手工制作好的、包含示例数据的“目标Excel”文件，另存为XML。与你上一步生成的XML进行对比（可以使用Diff工具），差异点往往就是问题的根源。

最后，我个人在多次使用这套方案后的体会是，它的优势在于将视觉设计交还给工具（Excel），将逻辑处理交还给代码（Java），达成了很好的关注点分离。初期搭建框架和理解XML结构会有一点学习成本，但一旦跑通，后续开发各种复杂报表的效率提升是线性的。对于团队协作来说，让熟悉业务的产品或运营同学直接用Excel画原型图，这张图稍加修改就能变成可用的导出模板，这种协同效率的提升，是纯代码方式难以比拟的。