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

Java POI安装步骤？

admin
后端开发
2025-06-20
2142

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依赖到项目

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

Java POI安装步骤？第1张

方式1：Maven项目（推荐）

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

<dependencies>
    <!-- 核心库 -->
    <dependency>
        <groupId>org.apache.poi</groupId>
        <artifactId>poi</artifactId>
        <version>5.2.3</version>
    </dependency>
    <!-- 处理Excel（xlsx格式） -->
    <dependency>
        <groupId>org.apache.poi</groupId>
        <artifactId>poi-ooxml</artifactId>
        <version>5.2.3</version>
    </dependency>
</dependencies>

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

方式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正确,则安装成功。

常见问题解决

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