Apache POI 5.5.1 介绍与选型指南

一、信息基准

1.1 基本信息

• 查询日期：2026-10-18
• 本文基准版本：Apache POI 5.5.1（官方当前最新稳定版）
• 维护方：Apache Software Foundation（Apache POI 项目）
• 开源许可：Apache License 2.0（官方下载页与 POM 均声明）
• 发行形态：源码包 + Maven Central 二进制工件（org.apache.poi，5.2.3 为最后提供 poi-bin 压缩包的版本）

1.2 版本依据

• 官方下载页明确"最新稳定版为 Apache POI 5.5.1"，公告日期 2025 年 11 月 30 日，源码包为 apache-poi-src-5.5.1-20251126.tgz。
• Maven Central org.apache.poi:poi 元数据 release 与 latest 均为 5.5.1，元数据最近更新时间 2025-11-30，与官方公告一致。

1.3 官方来源清单

二、软件概述

2.1 软件定位

本文介绍 Apache POI 5.5.1。Apache POI 是 Apache 软件基金会下用纯 Java 读写微软 Office 文件格式的主项目：既覆盖基于 OLE 2 复合文档格式的旧版二进制格式（Excel 97-2003 的 xls、Word 97-2003 的 doc、PowerPoint 的 ppt 等），也覆盖基于 OOXML（ECMA-376）的新版格式（xlsx、docx、pptx 等），并提供文本抽取能力供检索类系统使用。

2.2 发布状态

官方下载页公告 POI 5.5.1 于 2025 年 11 月 30 日发布，包含新功能与大量缺陷修复；5.2.3 之后不再发布 poi-bin 压缩包，统一通过 Maven Central 分发 jar，不使用构建工具的用户可从 Maven 中央仓库目录直接取包。

三、核心架构

3.1 组件划分（引自官方组件总览）

3.2 统一模型

电子表格侧以 Workbook/Sheet/Row/Cell 统一模型贯穿 HSSF 与 XSSF，使同一套业务代码可同时产出 xls 与 xlsx；文档侧组件各自提供对应的 Document 模型与文本抽取器。

四、功能特性

4.1 电子表格读写

完整读写 xls/xlsx：单元格类型、日期、公式（含公式计算器）、样式、边框、字体、合并单元格等能力，官方快速指南逐项给出用法。

4.2 大表流式写出

SXSSF 以滑动窗口方式写 xlsx，将内存占用与窗口大小绑定，适合导出超大数据量报表。

4.3 Word/PowerPoint/Outlook 处理

XWPF 支持 docx 的段落、表格、样式读写；HWPF/HSLF/XSLF/HSMF 等覆盖旧版二进制格式与消息文件。

4.4 文本抽取

各组件内置 Extractor 文本抽取能力，被 Apache Tika 等项目作为 Office 解析底座使用，适合文档检索与内容分析。

五、快速上手

5.1 Maven 依赖

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

说明：官方下载页声明 5.5.1 的工件发布于 Maven Central，Group ID 为 org.apache.poi；poi-ooxml 为处理 OOXML 的聚合入口。来源：https://poi.apache.org/download.html

5.2 最小读写示例

以下代码引自官方"Busy Developers' Guide to HSSF and XSSF Features"快速指南：

Workbook wb = new XSSFWorkbook();

try (OutputStream fileOut = new FileOutputStream("workbook.xlsx")) {
    wb.write(fileOut);
}

创建工作表与单元格（同页示例）：

Workbook wb = new HSSFWorkbook();
//Workbook wb = new XSSFWorkbook();
CreationHelper createHelper = wb.getCreationHelper();
Sheet sheet = wb.createSheet("new sheet");

// Create a row and put some cells in it. Rows are 0 based.
Row row = sheet.createRow(0);

来源：https://poi.apache.org/components/spreadsheet/quick-guide.html

说明：本文为纯官方资料溯源整理，未做本地安装与运行实测。

六、适用场景与限制

6.1 适用场景

• Java 服务端生成与解析 Excel 报表（含样式、公式、多 Sheet）；
• 大数据量导出场景使用 SXSSF 流式写出；
• Word/PowerPoint/Outlook 消息的程序化处理与文本抽取；
• 需要同时兼容旧版二进制格式（xls/doc/ppt）与 OOXML 的系统。

6.2 限制

• 5.2.3 起不再提供 poi-bin 压缩包，未使用 Maven/Gradle 的环境需自行从中央仓库目录取 jar；
• XSSF 全量读写在内存中承载文档对象模型，超大文件需切换 SXSSF（写）或事件模式（读）；
• 旧版二进制组件（HWPF 等）写能力有限，官方以读为主描述；
• POI 面向格式处理，不提供电子表格计算引擎级的功能（如复杂财务函数全量兼容）。

七、同类选型对比

7.1 候选说明

同类候选选取 docx4j（OOXML 文档专精的 Java 库）、fastexcel（org.dhatim:fastexcel，流式 xlsx 读写库）与 easyexcel（阿里系 Excel 工具库），版本数据于 2026-10-18 实查 Maven Central。

7.2 量化对比

数据来源：repo1.maven.org（org.apache.poi:poi、org.docx4j:docx4j-JAXB-ReferenceImpl、org.dhatim:fastexcel 及 fastexcel-parent、com.alibaba:easyexcel），查询日期 2026-10-18。

7.3 选型建议

若需要一站式覆盖 Office 全家桶格式且能接受全量对象模型，选 POI；若只做 docx 深度操作，选 docx4j；若只做 xlsx 且追求低内存流式读写，选 fastexcel；若偏好注解驱动的 Excel 快速开发但需注意其版本更新节奏已放缓。

八、参考链接

• 官方主页：https://poi.apache.org/
• 官方下载页：https://poi.apache.org/download.html
• 组件总览：https://poi.apache.org/components/index.html
• 电子表格快速指南：https://poi.apache.org/components/spreadsheet/quick-guide.html
• Maven Central：https://repo1.maven.org/maven2/org/apache/poi/poi/
• 历史归档：https://archive.apache.org/dist/poi/