Java POI：Excel 文件读写详解及高级应用287

Apache POI 是一个强大的 Java API，用于处理各种 Microsoft Office 文件格式，包括 XLS、XLSX、XLSM、XLTX、DOC、DOCX 等。其中，对 Excel 文件的读写操作是 POI 最常用的功能之一。本文将深入探讨 Java POI 在 Excel 文件处理方面的应用，涵盖基础操作、高级技巧以及常见问题的解决方法。

一、环境搭建与依赖引入

首先，我们需要在项目中引入 POI 的相关依赖。使用 Maven 或 Gradle 可以方便地管理依赖。以下是用 Maven 引入依赖的示例：```xml

poi
5.2.3

poi-ooxml
5.2.3

```

其中，`poi` 用于处理xls文件，`poi-ooxml` 用于处理xlsx文件。根据需要选择合适的依赖。引入依赖后，即可开始编写代码。

二、基础操作：读取 Excel 文件

读取 Excel 文件通常涉及到以下步骤：创建 Workbook 对象，获取 Sheet 对象，遍历行和单元格，读取单元格的值。```java
import .*;
import ;
import ;
import ;
import ;
public class ReadExcel {
public static void main(String[] args) throws IOException {
String filePath = ""; // 替换为你的文件路径
InputStream inputStream = new FileInputStream(filePath);
Workbook workbook = (inputStream); // 自动识别 xls 或 xlsx
Sheet sheet = (0); // 获取第一个 sheet
for (Row row : sheet) {
for (Cell cell : row) {
switch (()) {
case STRING:
(() + "\t");
break;
case NUMERIC:
if ((cell)) {
(() + "\t");
} else {
(() + "\t");
}
break;
case BOOLEAN:
(() + "\t");
break;
case FORMULA:
(() + "\t"); // 显示公式
break;
default:
(" \t");
}
}
();
}
();
();
}
}
```

这段代码演示了如何读取 xlsx 文件，并根据单元格类型打印不同的值。记得替换 `""` 为你的文件实际路径。对于 xls 文件，只需修改 `Workbook` 的创建方式即可。

三、基础操作：写入 Excel 文件

写入 Excel 文件的步骤与读取类似，但需要创建新的 Workbook 和 Sheet，然后设置单元格的值。```java
import .*;
import ;
import ;
import ;
import ;
public class WriteExcel {
public static void main(String[] args) throws IOException {
Workbook workbook = new XSSFWorkbook(); // 创建 xlsx 工作簿
Sheet sheet = ("Sheet1"); // 创建 Sheet
Row row = (0); // 创建第一行
Cell cell = (0); // 创建第一个单元格
("Hello, POI!"); // 设置单元格值
OutputStream outputStream = new FileOutputStream(""); // 替换为你的输出文件路径
(outputStream);
();
();
}
}
```

这段代码创建了一个新的 xlsx 文件，并在第一个单元格中写入文本。同样，你可以根据需要创建更多行和单元格，并设置不同的单元格类型和值。

四、高级应用：样式设置、公式计算、图片插入

POI 提供了丰富的功能来定制 Excel 文件的样式，例如设置字体、颜色、边框、对齐方式等。还可以使用 POI 进行公式计算以及插入图片。

样式设置示例：```java
CellStyle style = ();
Font font = ();
(true);
((short) 12);
(font);
(style);
```

公式计算示例：```java
("SUM(A1:A10)");
```

图片插入示例：这需要引入额外的依赖 `poi-ooxml-schemas`。具体操作较为复杂，需要参考 POI 官方文档。

五、错误处理与性能优化

在处理 Excel 文件时，需要注意以下几点：
异常处理：使用 try-catch 块捕获潜在的异常，例如 `IOException`。
资源释放：确保在使用完毕后关闭 Workbook 和 InputStream/OutputStream。
内存管理：对于大型 Excel 文件，需要考虑内存管理问题，可以考虑分批读取或写入数据。
数据类型转换：注意单元格值的类型转换，避免类型不匹配的错误。

六、总结

本文介绍了 Java POI 库的基本使用方法，包括读取和写入 Excel 文件，以及一些高级应用。掌握 POI 的使用，可以极大地方便 Java 程序与 Excel 文件的交互。为了更深入的学习，建议查阅 POI 官方文档，并参考更多示例代码。

注意：本文提供的代码仅供参考，实际应用中需要根据具体需求进行修改和完善。

2025-08-07

上一篇：Java字符串补足空格：详解多种实现方法及性能比较

下一篇：Java输入检查的最佳实践与常见方法