1. 项目概述：为什么POI是Java处理Excel的“瑞士军刀”

如果你正在用Java做后端开发，或者需要处理任何与数据报表、批量导入导出相关的功能，那么“POI导入导出Excel”这个需求你大概率绕不过去。这个标题看起来平平无奇，但它背后解决的，是开发中一个高频且“痛感”极强的场景：如何让程序自动读写Excel文件。想象一下，运营同事丢给你一个几百行的用户数据Excel，要求你导入系统；或者老板需要一份复杂的销售报表，你总不能手动复制粘贴吧。这时候，Apache POI这个Java库就成了你的得力助手。它就像一把“瑞士军刀”，专门用来解析和生成Microsoft Office格式的文档，其中对Excel（.xls和.xlsx）的支持最为成熟和常用。

我选择在IDEA这个集成开发环境里来聊这个“简单运用”，是因为对于大多数Java开发者，IDEA是吃饭的家伙。在IDEA里搞定POI，意味着从环境搭建、代码编写、调试到问题排查，形成了一条完整的本地开发流水线。这个“简单运用”的目标很明确：不追求大而全的POI高级特性，而是聚焦于最核心、最常用的场景——如何用最少的代码，可靠地实现Excel数据的读取和写入。无论是处理客户名单、订单记录，还是生成统计报表，掌握这个基础技能，就能解决工作中80%的Excel自动化需求。接下来，我会带你从零开始，拆解每一个步骤，并分享那些官方文档里不会写的“踩坑”经验。

2. 环境准备与项目搭建

在开始写代码之前，把“战场”打扫干净是高效开发的第一步。在IDEA中，我们通常使用Maven或Gradle来管理项目依赖，这里以最普及的Maven为例。

2.1 创建Maven项目与引入POI依赖

打开IDEA，选择“New Project”，在左侧选择“Maven”，直接点击“Next”即可创建一个标准的Maven项目。项目创建成功后，找到项目根目录下的pom.xml文件，这是Maven项目的核心配置文件。

POI是一个模块化的项目，针对不同的Office组件和文件格式，有不同的子模块。对于处理新版Excel（.xlsx，即Office 2007及以上版本），我们主要需要poi-ooxml这个依赖，因为它会自动引入核心的poi模块以及其他必要的依赖。

在你的pom.xml文件的<dependencies>标签内，添加以下依赖：

<dependencies> <!-- Apache POI for .xlsx (Office Open XML) --> <dependency> <groupId>org.apache.poi</groupId> <artifactId>poi-ooxml</artifactId> <version>5.2.3</version> <!-- 请注意使用最新稳定版本 --> </dependency> </dependencies>

这里有几个关键点需要注意：

1. 版本选择：我写这篇文章时，5.2.3是一个广泛使用的稳定版本。你可以在 Maven中央仓库 查看最新版本。建议使用较新的稳定版，因为它们修复了旧版的许多Bug并可能带来性能提升。
2. 依赖范围：我们没有指定<scope>，默认为compile，意味着这个依赖在编译、测试和运行时都需要。
3. IDEA的依赖下载：添加依赖并保存pom.xml后，IDEA通常会右上角弹出提示，让你导入变更（Import Changes）。点击它，或者右键点击pom.xml文件选择“Maven -> Reload project”。IDEA会自动从远程仓库下载所需的JAR包到你的本地仓库。

注意：如果你还需要处理老版本的.xls（Excel 97-2003）格式，poi-ooxml同样支持，因为其底层依赖了处理.xls的模块。所以，只引入poi-ooxml这一个依赖，通常就能覆盖新旧两种Excel格式，这是最省心的做法。

2.2 理解POI的核心对象模型

在动手写代码前，花几分钟理解POI操作Excel的“世界观”至关重要，这能让你后续的编码事半功倍。POI用一套面向对象的模型来映射Excel文件的结构，主要对象如下：

• Workbook（工作簿）：对应一个完整的Excel文件。它是所有操作的起点。对于.xlsx文件，它的实现类是XSSFWorkbook；对于.xls文件，是HSSFWorkbook。Workbook工厂类可以根据文件后缀自动创建合适的实例。
• Sheet（工作表）：对应Excel文件中的一个Sheet页，比如“Sheet1”。一个Workbook可以包含多个Sheet。
• Row（行）：对应Sheet中的一行。
• Cell（单元格）：对应一行中的一个单元格。这是存放具体数据（数字、字符串、日期、公式等）的地方。

它们的关系是层层包含的：Workbook->Sheet->Row->Cell。你的所有操作，无论是读还是写，基本都是沿着这条路径进行的。

一个常见的误区：很多新手会疑惑，为什么我创建了Workbook和Sheet，但直接去getRow(0)却得到null？这是因为在POI的模型中，Sheet更像一个“行”的容器，你需要先创建或获取Row对象，然后才能操作其下的Cell。对于读取一个已存在的文件，如果某一行是空的，那么对应的Row对象就是null。这一点在遍历行时需要特别注意。

3. 核心操作一：将数据写入Excel（导出）

导出功能，即根据程序中的数据生成一个Excel文件，是报表生成、数据下载等场景的核心。我们从创建一个最简单的Excel文件开始。

3.1 基础写入：创建文件与填充数据

假设我们要导出一份简单的用户列表，包含ID、姓名和年龄。代码如下：

import org.apache.poi.ss.usermodel.*; import org.apache.poi.xssf.usermodel.XSSFWorkbook; import java.io.FileOutputStream; import java.io.IOException; public class ExcelExporter { public static void main(String[] args) { // 1. 创建一个新的工作簿（.xlsx格式） Workbook workbook = new XSSFWorkbook(); // 2. 创建一个工作表，并指定名称 Sheet sheet = workbook.createSheet("用户列表"); // 3. 创建标题行（第0行） Row headerRow = sheet.createRow(0); String[] headers = {"用户ID", "姓名", "年龄"}; for (int i = 0; i < headers.length; i++) { Cell cell = headerRow.createCell(i); cell.setCellValue(headers[i]); // 可选：为标题行设置简单样式，如加粗 CellStyle headerStyle = workbook.createCellStyle(); Font headerFont = workbook.createFont(); headerFont.setBold(true); headerStyle.setFont(headerFont); cell.setCellStyle(headerStyle); } // 4. 模拟数据，创建数据行 Object[][] userData = { {1, "张三", 25}, {2, "李四", 30}, {3, "王五", 28} }; int rowNum = 1; // 数据从第1行开始（第0行是标题） for (Object[] rowData : userData) { Row row = sheet.createRow(rowNum++); for (int i = 0; i < rowData.length; i++) { Cell cell = row.createCell(i); // 根据数据类型设置单元格值 Object value = rowData[i]; if (value instanceof String) { cell.setCellValue((String) value); } else if (value instanceof Integer) { cell.setCellValue((Integer) value); } else if (value instanceof Double) { cell.setCellValue((Double) value); } // 可以继续扩展其他类型，如Date、Boolean等 } } // 5. 可选：自动调整列宽（根据内容） for (int i = 0; i < headers.length; i++) { sheet.autoSizeColumn(i); } // 6. 将工作簿写入文件 try (FileOutputStream outputStream = new FileOutputStream("用户列表.xlsx")) { workbook.write(outputStream); System.out.println("Excel文件生成成功！"); } catch (IOException e) { e.printStackTrace(); } finally { // 7. 非常重要：关闭工作簿，释放资源（尤其是处理大量数据时） try { workbook.close(); } catch (IOException e) { e.printStackTrace(); } } } }

代码解读与实操要点：

1. 资源关闭：这是最容易出错的地方之一。Workbook对象在写入文件后必须关闭（调用close()方法），否则可能导致生成的文件损坏，或者内存泄漏（如果数据量很大）。使用try-with-resources语句（如示例中处理FileOutputStream）是更优雅和安全的方式，但注意XSSFWorkbook本身没有实现AutoCloseable接口（在较新版本中已实现），所以我们需要在finally块中手动关闭。从POI 4.0.0开始，Workbook实现了AutoCloseable，你可以直接用try (Workbook workbook = new XSSFWorkbook()) { ... }。
2. 数据类型处理：Cell.setCellValue()方法有多个重载版本，接受String、double、boolean、Date、RichTextString等类型。在设置值时，最好根据数据的原始类型调用对应的方法，这能保证Excel正确识别单元格格式（例如，数字不会被当成文本）。
3. 自动调整列宽：Sheet.autoSizeColumn(int columnIndex)方法非常实用，它可以根据该列中最长的内容自动设置一个合适的宽度。但要注意，这是一个开销较大的操作，如果数据行非常多（比如上万行），可能会影响性能。对于大数据量导出，建议估算一个固定宽度，或者分批处理。

3.2 样式与格式深度定制

让导出的Excel更专业、更易读，离不开样式。POI的样式系统稍微复杂但功能强大。

// 创建一个居中对齐、带边框的单元格样式 CellStyle dataStyle = workbook.createCellStyle(); // 1. 对齐方式 dataStyle.setAlignment(HorizontalAlignment.CENTER); // 水平居中 dataStyle.setVerticalAlignment(VerticalAlignment.CENTER); // 垂直居中 // 2. 边框 dataStyle.setBorderTop(BorderStyle.THIN); // 上边框，细线 dataStyle.setBorderBottom(BorderStyle.THIN); dataStyle.setBorderLeft(BorderStyle.THIN); dataStyle.setBorderRight(BorderStyle.THIN); // 设置边框颜色（可选） dataStyle.setTopBorderColor(IndexedColors.BLACK.getIndex()); // ... 设置其他边框颜色 // 3. 背景色 dataStyle.setFillPattern(FillPatternType.SOLID_FOREGROUND); dataStyle.setFillForegroundColor(IndexedColors.LIGHT_YELLOW.getIndex()); // 浅黄色背景 // 4. 字体 Font font = workbook.createFont(); font.setFontName("微软雅黑"); // 字体名称 font.setFontHeightInPoints((short) 11); // 字号 font.setColor(IndexedColors.DARK_BLUE.getIndex()); // 字体颜色 dataStyle.setFont(font); // 5. 数据格式（例如，将数字显示为货币或百分比） CellStyle currencyStyle = workbook.createCellStyle(); DataFormat format = workbook.createDataFormat(); currencyStyle.setDataFormat(format.getFormat("¥#,##0.00")); // 格式如：¥1,234.56 // 将样式应用到单元格 cell.setCellStyle(dataStyle);

样式使用的核心心得：

• 样式对象复用：CellStyle和Font对象是绑定到Workbook的。最佳实践是，为同一种格式的单元格创建一次样式，然后复用到所有需要的单元格上。不要在每个单元格处都createCellStyle()，这会导致内存浪费，并且在早期版本的POI中，一个工作簿内可创建的样式数量有上限（约64000个），极易触发异常。
• 样式是独立的：CellStyle包含了字体、边框、对齐、背景等所有格式信息。当你修改一个CellStyle对象的属性时，所有应用了这个样式的单元格都会同步改变。
• 关于字体：setFontName中指定的字体名称，是期望在打开Excel的电脑上存在的字体。如果该电脑没有安装“微软雅黑”，Excel会使用默认字体（如宋体）替代。对于需要确保显示一致性的场景（如服务器生成报表供下载），这是一个需要考虑的风险点。

3.3 处理特殊数据类型：日期与公式

日期处理：在Excel内部，日期是以数值形式存储的（从1900年1月0日或1月1日开始的天数）。POI提供了CreationHelper来帮助创建正确的日期格式。

// 创建日期单元格 Cell dateCell = row.createCell(0); Date currentDate = new Date(); dateCell.setCellValue(currentDate); // 创建日期格式样式 CellStyle dateStyle = workbook.createCellStyle(); CreationHelper createHelper = workbook.getCreationHelper(); // 设置日期格式，例如“yyyy-MM-dd” dateStyle.setDataFormat(createHelper.createDataFormat().getFormat("yyyy-MM-dd")); dateCell.setCellStyle(dateStyle);

公式处理：POI支持在单元格中设置公式。公式字符串的写法与在Excel中完全一致。

// 假设A1=10， B1=20， 在C1设置求和公式 Cell cellA1 = row.createCell(0); cellA1.setCellValue(10); Cell cellB1 = row.createCell(1); cellB1.setCellValue(20); Cell cellC1 = row.createCell(2); cellC1.setCellFormula("SUM(A1:B1)"); // 设置公式 // 注意：POI在写入文件时，默认只保存公式字符串，不计算结果。 // 如果需要在生成文件时就计算出结果，需要在写入前调用： // FormulaEvaluator evaluator = workbook.getCreationHelper().createFormulaEvaluator(); // evaluator.evaluateFormulaCell(cellC1); // 这会计算并缓存结果 // 但更常见的做法是，让Excel在打开文件时自动计算公式。

4. 核心操作二：从Excel读取数据（导入）

导入功能，即解析上传的Excel文件，将数据提取到程序（如数据库）中，是数据采集、批量初始化等场景的关键。

4.1 基础读取：遍历行与列

import org.apache.poi.ss.usermodel.*; import org.apache.poi.xssf.usermodel.XSSFWorkbook; import java.io.FileInputStream; import java.io.IOException; import java.util.ArrayList; import java.util.List; public class ExcelImporter { public static void main(String[] args) { String filePath = "用户列表.xlsx"; List<User> userList = new ArrayList<>(); // 使用try-with-resources确保流和Workbook被正确关闭 try (FileInputStream inputStream = new FileInputStream(filePath); Workbook workbook = new XSSFWorkbook(inputStream)) { // 1. 获取第一个工作表（也可以根据名称获取：workbook.getSheet("Sheet1")） Sheet sheet = workbook.getSheetAt(0); // 2. 遍历每一行。注意：getPhysicalNumberOfRows()返回有物理定义的行数（可能跳过空行中间） // 更常用的方式是获取最后一行编号，然后遍历。 int lastRowNum = sheet.getLastRowNum(); // 最后一行的索引（从0开始） for (int i = 0; i <= lastRowNum; i++) { Row row = sheet.getRow(i); if (row == null) { // 跳过完全空白的行 continue; } // 3. 跳过标题行（假设第一行是标题） if (i == 0) { continue; } // 4. 遍历该行的单元格 User user = new User(); // 获取该行最后一个有内容的单元格编号 int lastCellNum = row.getLastCellNum(); // 注意：这是编号（从1开始计数？），实际是最后一个单元格索引+1 for (int j = 0; j < lastCellNum; j++) { Cell cell = row.getCell(j, Row.MissingCellPolicy.CREATE_NULL_AS_BLANK); // 使用CREATE_NULL_AS_BLANK策略，即使单元格不存在也返回一个空白单元格对象，避免NPE // 5. 根据单元格类型读取值 switch (cell.getCellType()) { case STRING: String cellValue = cell.getStringCellValue().trim(); // 根据列索引j，将值赋给User对象的对应字段 if (j == 0) { // 假设第一列是ID，但ID可能是数字，这里需要根据实际情况处理 // 如果Excel中ID是数字但被设置为文本格式，这里会读成STRING try { user.setId(Integer.parseInt(cellValue)); } catch (NumberFormatException e) { // 处理格式错误 user.setId(0); } } else if (j == 1) { user.setName(cellValue); } break; case NUMERIC: // 注意：Excel的日期也是NUMERIC类型，需要用DateUtil.isCellDateFormatted判断 if (DateUtil.isCellDateFormatted(cell)) { Date dateValue = cell.getDateCellValue(); // 处理日期... } else { double numericValue = cell.getNumericCellValue(); if (j == 2) { // 假设第三列是年龄 user.setAge((int) numericValue); } } break; case BOOLEAN: boolean boolValue = cell.getBooleanCellValue(); // 处理布尔值... break; case FORMULA: // 公式单元格，需要先计算公式值再读取 FormulaEvaluator evaluator = workbook.getCreationHelper().createFormulaEvaluator(); CellValue cellValue = evaluator.evaluate(cell); // 根据cellValue.getCellType()判断公式结果类型，再获取值 switch (cellValue.getCellType()) { case NUMERIC: double formulaNumericValue = cellValue.getNumberValue(); // 处理数字结果... break; case STRING: String formulaStringValue = cellValue.getStringValue(); // 处理字符串结果... break; // ... 其他类型 } break; case BLANK: case _NONE: // 空单元格，跳过或设置默认值 break; case ERROR: // 错误单元格，如#DIV/0! byte errorValue = cell.getErrorCellValue(); // 处理错误... break; default: // 未知类型 break; } } userList.add(user); } // 打印读取结果 for (User user : userList) { System.out.println(user); } } catch (IOException e) { e.printStackTrace(); } } // 简单的用户实体类 static class User { private int id; private String name; private int age; // 省略getter/setter和toString方法 } }

4.2 读取中的难点与精准处理策略

读取Excel远比写入复杂，因为你需要处理用户上传的各种“不规范”文件。

1. 空行与空单元格的判断：

   • sheet.getRow(i)可能返回null，这代表该行在文件中没有被定义过（完全空白行）。
   • row.getCell(j)也可能返回null，代表该单元格是空的。使用Row.MissingCellPolicy.CREATE_NULL_AS_BLANK策略可以安全地避免空指针，但会创建一个内容为空的Cell对象。
   • sheet.getLastRowNum()返回最后一个有内容的行的索引（从0开始）。sheet.getPhysicalNumberOfRows()返回有物理定义的行数，可能小于前者（如果中间有完全空白的行被跳过）。

2. 数据类型判断与转换（最大的坑）：

   • 数字与文本的混淆：用户在Excel中可能将数字（如手机号“13800138000”）以文本格式存储，或者将文本（如“001”）以数字格式存储。POI会根据单元格的格式类型（cell.getCellType()）来返回数据。对于格式模棱两可的数据，最稳妥的方式是：先按字符串读，再尝试转换。可以使用DataFormatter类，它能够按照单元格在Excel中显示的样子，将值格式化为字符串，无视其底层是数字还是日期。

     DataFormatter formatter = new DataFormatter(); String cellValueAsString = formatter.formatCellValue(cell); // 这样，无论单元格是数字123，还是文本“123”，都会得到字符串“123”。

   • 日期识别：NUMERIC类型的单元格可能是普通数字，也可能是日期。必须使用DateUtil.isCellDateFormatted(cell)进行判断。POI的DateUtil类提供了很多日期转换的实用方法。

3. 公式单元格的处理： 如果单元格包含公式，直接getStringCellValue()或getNumericCellValue()可能会得到公式字符串本身，而不是计算结果。必须使用FormulaEvaluator来对公式进行求值，如上面代码所示。对于导入场景，通常我们关心的是公式计算后的结果值。

4. 大文件读取与内存优化： 使用标准的XSSFWorkbook（处理.xlsx）会将整个文件加载到内存中，对于几十MB甚至上百MB的Excel文件，很容易导致内存溢出（OOM）。POI提供了两种流式读取API来解决这个问题：

   • 对于.xlsx(SXSSF)：SXSSFWorkbook是XSSFWorkbook的流式版本，它通过滑动窗口机制，只将一部分行保留在内存中，非常适合写入超大文件。
   • 对于.xlsx读取 (XSSF and SAX)：使用XSSFReader配合SAX（Simple API for XML）解析器进行事件驱动型读取。这是读取超大Excel文件的标准且推荐的做法。它不会将整个文档对象模型加载到内存，而是像解析XML一样，在读取过程中触发事件（如开始行、结束行、单元格数据），由你的代码来处理这些事件。虽然API比Workbook更底层、更复杂，但对于处理海量数据导入是必不可少的技能。基本思路是使用OPCPackage打开文件，获取XSSFReader，然后获取SharedStringsTable和StylesTable，最后使用自己的SheetHandler（实现XSSFSheetXMLHandler.SheetContentsHandler接口）来逐行处理数据。

5. 实战进阶与性能调优

掌握了基础读写，我们可以应对大部分场景。但当数据量变大、需求变复杂时，就需要一些进阶技巧。

5.1 处理大数据量：SXSSF流式写入

当需要导出数万、数十万行数据时，使用普通的XSSFWorkbook会消耗大量内存，甚至导致OutOfMemoryError。SXSSFWorkbook应运而生。

import org.apache.poi.xssf.streaming.SXSSFWorkbook; import org.apache.poi.xssf.streaming.SXSSFSheet; import org.apache.poi.xssf.streaming.SXSSFRow; import org.apache.poi.xssf.streaming.SXSSFCell; // 创建SXSSFWorkbook，并指定在内存中保留的行数（窗口大小） SXSSFWorkbook workbook = new SXSSFWorkbook(100); // 保留100行在内存中 SXSSFSheet sheet = workbook.createSheet(); // 写入数据的方式与XSSF几乎完全相同 for (int i = 0; i < 100000; i++) { Row row = sheet.createRow(i); // ... 创建单元格并填充数据 // 当行索引超过窗口大小时，最早的行会被刷新到临时磁盘文件，以释放内存 } // 写入文件 try (FileOutputStream out = new FileOutputStream("bigfile.xlsx")) { workbook.write(out); } catch (IOException e) { e.printStackTrace(); } finally { // 重要：SXSSFWorkbook使用完毕后必须dispose，以删除临时文件 workbook.dispose(); workbook.close(); }

SXSSF核心要点：

• 原理：它在内存中维护一个指定大小的行窗口（如100行）。当写入新行导致超出窗口时，最早的行会被写入磁盘上的临时文件。最终写入输出流时，会将内存中的数据和临时文件合并。
• dispose()方法：必须调用。它会清理在磁盘上生成的临时文件。如果不调用，可能会在服务器上留下大量垃圾文件。
• 局限性：由于行会被刷到磁盘，因此不支持随机访问（例如，修改前面已经刷出的行的单元格）。它只适用于顺序写入的场景。另外，某些功能如autoSizeColumn在SXSSF上要么不可用，要么需要遍历所有行（会触发从临时文件重新读取，性能差），在大数据量下应避免使用，或手动估算列宽。

5.2 使用模板进行复杂导出

对于格式固定、样式复杂的报表（如合同、对账单），直接在代码里用POI API画样式非常繁琐且难以维护。更好的做法是：预先制作一个精美的Excel模板文件。

1. 使用Microsoft Excel或WPS等工具，设计好报表的样式、表头、固定文字、LOGO位置等，将需要动态填充数据的地方留空，或者用占位符（如${customerName}）标记。
2. 在Java程序中，使用POI读取这个模板文件（Workbook workbook = new XSSFWorkbook(templateFileInputStream)）。
3. 找到模板中预留的单元格，使用Cell.setCellValue()将实际数据填充进去。
4. 将填充好的Workbook写出到新的文件或输出流。

这种方法将“样式设计”和“数据填充”解耦，让专业的设计人员可以用熟悉的工具制作模板，开发者只需关注数据逻辑，大大提升了开发效率和报表的美观度。难点在于如何精准定位到模板中的目标单元格。通常有两种方式：

• 坐标定位：在制作模板时，记录下每个数据块所在的行列索引（如客户姓名在(2, 1)即第3行第2列）。代码中直接通过索引访问。
• 占位符搜索：在模板的单元格中写入特殊的占位符字符串（如#name#）。代码遍历所有单元格，查找包含占位符的单元格，替换其内容。这种方式更灵活，但遍历开销稍大。

5.3 常见问题排查与性能优化清单

1. NoClassDefFoundError: org/apache/poi/POIXMLDocumentPart

   • 问题：这是最常见的依赖问题。通常是因为poi-ooxml依赖没有正确引入其传递依赖（如poi、xmlbeans、commons-compress等）。
   • 解决：确保使用Maven或Gradle等构建工具，并且poi-ooxml的版本与其他POI模块（如果你显式引入了）的版本完全一致。Maven会自动处理传递依赖，所以只引入poi-ooxml通常是最安全的。

2. 导出文件损坏，无法用Excel打开

   • 可能原因1：Workbook或输出流 (OutputStream) 没有正确关闭。确保在finally块或使用try-with-resources关闭它们。
   • 可能原因2：在写入过程中发生了异常，导致文件数据不完整。确保异常处理逻辑不会导致只写了一半数据。
   • 可能原因3：并发写入同一个Workbook对象。POI的某些对象（如Workbook,Sheet）不是线程安全的。如果必须在多线程环境下生成Excel，可以考虑每个线程创建自己的Workbook，最后再合并，或者使用线程安全的写法（如加锁）。

3. 读取日期错误（差4年或1天）

   • 问题：Excel在Windows和Mac上有不同的日期系统（1900 vs. 1904）。POI默认使用1900日期系统。如果文件是在Mac上创建的，或者设置了1904日期系统，读取的日期就会出错。
   • 解决：检查workbook.isDate1904()。如果为true，需要使用DateUtil.getJavaDate(double date, boolean use1904Windowing)方法，并传入true参数来转换日期值。

4. 内存溢出 (OOM)

   • 场景：读取或写入非常大的Excel文件。
   • 解决：
     • 写入：使用SXSSFWorkbook进行流式写入。
     • 读取：使用基于SAX事件的API（XSSFReader）进行流式读取。
     • 通用：增加JVM堆内存（-Xmx参数），但这不是根本解决办法。分析代码，确保没有不必要的对象持有（如将整个文件数据缓存在一个List里）。及时关闭Workbook和流。

5. autoSizeColumn性能差或无效

   • 问题：在SXSSF上使用autoSizeColumn可能导致性能问题。对于大量数据的列，计算合适宽度本身就很耗时。
   • 解决：对于大数据量导出，放弃自动调整。根据业务数据预估一个固定宽度（如sheet.setColumnWidth(0, 20 * 256)// 20个字符宽度），或者提供一个“手动调整列宽”的提示给用户。

6. 中文乱码

   • 问题：现在已很少见，主要出现在处理非常老的文件或特定字体时。
   • 解决：确保读写文件时使用的字符集一致（通常UTF-8）。POI内部处理字符串通常是Unicode。如果从其他系统获取的字节流编码不明，需先进行正确转换。

6. 在IDEA中高效开发的技巧

最后，分享几个在IntelliJ IDEA中开发POI相关功能时，能提升效率的小技巧。

1. 利用IDEA的依赖分析：在pom.xml中，将鼠标悬停在poi-ooxml依赖上，IDEA会显示其引入的所有传递依赖。这有助于你理解项目的依赖树，避免版本冲突。

2. 调试时查看POI对象内部状态：在调试模式下，你可以查看Workbook、Sheet、Row、Cell等对象的内部属性。例如，查看一个Cell对象的cellType、stringCellValue、numericCellValue等，这对于排查读取数据时类型判断错误非常有用。

3. 使用代码模板快速生成样板代码：POI的读写操作有很多固定模式的代码（如遍历行、判断单元格类型）。你可以在IDEA中创建Live Template。例如，创建一个名为poireadrow的模板，内容为遍历行的基本结构，以后只需输入缩写即可快速生成代码骨架。

4. 处理“找不到符号”错误：如果代码中无法识别XSSFWorkbook等类，首先检查Maven依赖是否已成功下载（查看External Libraries）。可以尝试Maven -> Reload Project。有时IDEA的索引可能滞后，可以执行File -> Invalidate Caches and Restart。

5. 阅读源码和Javadoc：POI的API设计良好，但有些细节隐藏在Javadoc中。在IDEA中，Ctrl+左键点击类名或方法名，可以直接跳转到其源码或Javadoc。这是学习POI高级用法和排查疑难问题的最直接途径。例如，查看DataFormatter类的Javadoc，能深刻理解它如何处理各种单元格格式。

掌握POI导入导出Excel，本质上是掌握了程序与通用数据文件格式交互的一种重要能力。从简单的列表导出，到复杂的模板化报表，再到海量数据的流式处理，这套工具链能覆盖从初创公司到大型企业的各种数据交换需求。真正的熟练，来自于在解决一个个具体的、甚至有些“刁钻”的业务需求过程中，积累下的对细节的把握和对异常的处理经验。希望这篇从环境搭建到实战进阶的长文，能成为你手边一份可靠的参考。