Apache POI 是一个用于操作 Microsoft Office 格式文件的 Java 库，要使用它，您需要将相应的 JAR 包（或更现代的 Maven/Gradle 依赖）添加到您的项目中。
以下是几种主流的下载和配置方式,强烈推荐使用 Maven 或 Gradle，而不是手动下载 JAR。
使用 Maven (强烈推荐)
这是目前最主流、最方便的依赖管理方式，您只需在项目的 pom.xml 文件中添加相应的依赖项即可，Maven 会自动下载所需的 JAR 包及其所有传递性依赖。
打开您的 pom.xml 文件。
在 <dependencies> 标签内添加以下内容。
您可以根据您的需求选择不同的模块。poi 和 poi-ooxml 是最常用的组合。
完整依赖示例 (适用于最新稳定版)
<dependencies>
<!-- 核心 POI 模块，用于处理 .xls 格式 (Excel 97-2003) -->
<dependency>
<groupId>org.apache.poi</groupId>
<artifactId>poi</artifactId>
<version>5.2.5</version> <!-- 请访问官网查看最新版本 -->
</dependency>
<!-- 用于处理 .xlsx 格式 (Excel 2007+) 以及其他 Office 格式 -->
<dependency>
<groupId>org.apache.poi</groupId>
<artifactId>poi-ooxml</artifactId>
<version>5.2.5</version> <!-- 版本号必须与 poi 保持一致 -->
</dependency>
<!-- 如果需要处理 .docx 或 .pptx，也需要添加此依赖 -->
<dependency>
<groupId>org.apache.poi</groupId>
<artifactId>poi-ooxml-lite</artifactId>
<version>5.2.5</version>
</dependency>
</dependencies>
如何获取最新版本？ 访问 Apache POI 官方 Maven 仓库，在页面顶部可以找到最新的稳定版本号。
使用 Gradle
如果您使用的是 Gradle 构建工具，操作类似，只需在 build.gradle 文件中添加依赖。
打开您的 build.gradle (或 build.gradle.kts) 文件。
在 dependencies 代码块中添加以下内容。
// Groovy DSL
dependencies {
// 核心 POI 模块
implementation 'org.apache.poi:poi:5.2.5' // 请替换为最新版本
// 用于处理 .xlsx 等格式
implementation 'org.apache.poi:poi-ooxml:5.2.5' // 版本号必须一致
}
如果是 Kotlin DSL (build.gradle.kts)：
// Kotlin DSL
dependencies {
// 核心 POI 模块
implementation("org.apache.poi:poi:5.2.5") // 请替换为最新版本
// 用于处理 .xlsx 等格式
implementation("org.apache.poi:poi-ooxml:5.2.5") // 版本号必须一致
}
手动下载 JAR 包 (不推荐)
如果您不使用 Maven 或 Gradle，或者有特殊需求，可以直接从官网下载 JAR 包。
步骤：
-
访问官方下载页面： 前往 Apache POI 官方下载页面。
-
选择二进制分发版 (Binary Distributions)： 在页面中找到 "Binary Distributions" 部分，下载最新的
Binary Distribution包，文件名通常类似poi-bin-X.X.X-YYYYMMDD.zip。 -
解压文件： 下载后，解压这个 ZIP 压缩包，您会看到一个
poi-X.X.X的文件夹。 -
找到 JAR 文件： 进入
poi-X.X.X文件夹，然后进入lib目录，这里包含了所有需要的 JAR 文件。poi-*.jar: 核心库。poi-ooxml-*.jar: 用于处理 OOXML 格式（.xlsx, .docx 等）。ooxml-lib目录下还有一些第三方依赖库，如xml-apis,stax-api等。
-
添加到项目： 将这些 JAR 文件手动添加到您的项目中，根据您使用的 IDE，操作方式略有不同：
- 在 Eclipse/STS 中: 右键点击项目 -> Build Path -> Configure Build Path -> Libraries -> Add External JARs... -> 选择所有需要的 JAR 文件。
- 在 IntelliJ IDEA 中: 将 JAR 文件拖入
lib文件夹（如果不存在则创建），然后右键点击这些 JAR 文件，选择 "Add as Library..."。
版本选择建议
- POI 5.x: 这是当前的稳定主版本，推荐新项目使用，它移除了对旧版 Java 6/7 的支持，性能和功能都有改进。
- POI 4.x: 如果您必须使用 Java 8 或更低版本，可以选择 POI 4.x。
- POI 3.x: 非常古老的版本，除非维护非常老的项目，否则不应使用。
常见模块说明
| 模块 | Artifact ID | 描述 |
|---|---|---|
| poi | poi |
核心模块，支持 Excel 97-2003 (.xls) 格式。 |
| poi-ooxml | poi-ooxml |
支持 Office Open XML 格式，如 Excel 2007+ (.xlsx)、Word (.docx)、PowerPoint (.pptx)。依赖 poi 和 ooxml-lib。 |
| poi-ooxml-lite | poi-ooxml-lite |
轻量级的 poi-ooxml，不包含所有功能，但体积更小，适用于只需要处理 .xlsx 的场景。 |
| poi-scratchpad | poi-scratchpad |
包含一些实验性或非官方支持的功能，如处理 Visio 文件。 |
| 方法 | 优点 | 缺点 | 推荐度 |
|---|---|---|---|
| Maven/Gradle | 自动管理依赖和版本，避免冲突，构建流程标准化 | 需要学习构建工具的基础知识 | ⭐⭐⭐⭐⭐ (首选) |
| 手动下载 | 无需构建工具，直接获取文件 | 依赖管理繁琐，容易遗漏或冲突，版本更新麻烦 | ⭐ (不推荐) |
对于任何新的 Java 项目，请优先选择 Maven 或 Gradle 来管理 POI 的依赖，这是最专业、最高效的做法。
