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官网下载。
-
构建工具（二选一）
添加POI依赖到项目
根据项目类型选择以下方式：
方式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（流式处理，节省内存）。
最佳实践建议
引用说明基于Apache POI官方文档和Java开发社区实践，确保方法可靠，示例代码已通过JDK 17与POI 5.2.3测试验证。
原创文章，发布者：酷盾叔，转转请注明出处：https://www.kd.cn/ask/32831.html
