当前位置：首页 > 后端开发 > 正文

Java POI安装步骤？

admin
后端开发
2025-06-20
5

Apache POI安装：通过Maven在pom.xml添加依赖（如 org.apache.poipoi2.3），或Gradle在build.gradle添加 implementation 'org.apache.poi:poi:5.2.3'，也可手动下载JAR并导入项目。

Java POI（Apache POI）是一个用于操作Microsoft Office格式文件（如Excel、Word）的开源Java库，它通过Java代码读写文件，无需安装独立软件，只需在项目中添加依赖即可,以下是详细步骤：

安装前的准备

Java环境
确保已安装JDK 1.6或更高版本（推荐JDK 8+）。
终端验证命令：
java -version
若未安装，从Oracle JDK官网下载。
构建工具（二选一）
- Maven（推荐）：管理依赖更便捷。
- Gradle：灵活高效的构建工具。
  若未安装，参考Maven官网或Gradle官网。

添加POI依赖到项目

根据项目类型选择以下方式：

方式1：Maven项目（推荐）

在pom.xml中添加依赖（以最新版5.2.3为例）：

<dependencies>  <dependency> <groupId>org.apache.poi</groupId> <artifactId>poi</artifactId> <version>5.2.3</version> </dependency>  <dependency> <groupId>org.apache.poi</groupId> <artifactId>poi-ooxml</artifactId> <version>5.2.3</version> </dependency> </dependencies>

保存后，Maven会自动下载依赖（首次构建需联网）。

Java POI安装步骤？第1张

Java POI安装步骤？第2张

方式2：Gradle项目

在build.gradle中添加：

dependencies { implementation 'org.apache.poi:poi:5.2.3' implementation 'org.apache.poi:poi-ooxml:5.2.3' }

运行 gradle build 下载依赖。

方式3：手动添加JAR（无构建工具）

从Apache POI官网下载页下载poi-bin-*.zip。
解压后，将lib文件夹内所有JAR文件复制到项目的lib目录（需自行创建）。
IDE中右键JAR文件 → 选择Add as Library（以IntelliJ为例）。

验证安装是否成功

创建一个简单的Excel文件测试：

import org.apache.poi.xssf.usermodel.XSSFWorkbook; import org.apache.poi.xssf.usermodel.XSSFSheet; import org.apache.poi.xssf.usermodel.XSSFRow; import org.apache.poi.xssf.usermodel.XSSFCell; import java.io.FileOutputStream; public class PoiTest { public static void main(String[] args) throws Exception { // 1. 创建工作簿和工作表 try (XSSFWorkbook workbook = new XSSFWorkbook()) { XSSFSheet sheet = workbook.createSheet("TestSheet"); // 2. 创建行和单元格 XSSFRow row = sheet.createRow(0); XSSFCell cell = row.createCell(0); cell.setCellValue("POI安装成功！"); // 3. 保存文件 try (FileOutputStream out = new FileOutputStream("test.xlsx")) { workbook.write(out); } } System.out.println("Excel文件已生成！"); } }

运行后若生成test.xlsx正确,则安装成功。

Java POI安装步骤？第3张

常见问题解决

依赖冲突：
若报错NoClassDefFoundError，可能是版本不兼容。
解决：确保所有POI组件版本一致（如poi和poi-ooxml均为5.2.3）。
文件读写权限问题：
若生成文件失败,检查程序是否有写权限。
大型文件处理内存溢出：
使用SXSSFWorkbook替代XSSFWorkbook（流式处理，节省内存）。