Java 读取 Excel 最简单 POI 示例
Java读取Excel最简单方式是用ApachePOI,只需添加poi-ooxml依赖,代码示例可直接读取test.xlsx首行标题和第二行数据。
Java读取Excel最简单方式是用Apache POI,只需添加poi-ooxml依赖,代码示例可直接读取test.xlsx首行标题和第二行数据。

Java 读取 Excel 最简单的方式是用 Apache POI,尤其适合处理 .xls(HSSF)和 .xlsx(XSSF)格式。下面是一个零依赖、直接可跑的入门示例,只读取第一个 sheet 的前几行内容。
添加 Maven 依赖(只需一个)
如果你用 Maven,加这行到 pom.xml 即可(POI 自动包含 commons-collections4、commons-math3 等,不用额外引):
读取 Excel 的最简代码(.xlsx 格式)
以下代码读取 test.xlsx 文件,打印第一行标题和第二行数据:
import org.apache.poi.ss.usermodel.*;
import org.apache.poi.xssf.usermodel.XSSFWorkbook;
import java.io.FileInputStream;
import java.io.IOException;
public class ExcelReader {
public static void main(String[] args) throws IOException {
try (FileInputStream fis = new FileInputStream("test.xlsx");
Workbook workbook = new XSSFWorkbook(fis)) {
Sheet sheet = workbook.getSheetAt(0); // 第一个 sheet
// 读第 0 行(标题)
Row headerRow = sheet.getRow(0);
if (headerRow != null) {
System.out.print("标题:");
for (int i = 0; i < headerRow.getLastCellNum(); i++) {
Cell cell = headerRow.getCell(i);
System.out.print(getCellValue(cell) + "\t");
}
System.out.println();
}
// 读第 1 行(示例数据)
Row dataRow = sheet.getRow(1);
if (dataRow != null) {
System.out.print("数据:");
for (int i = 0; i < dataRow.getLastCellNum(); i++) {
Cell cell = dataRow.getCell(i);
System.out.print(getCellValue(cell) + "\t");
}
System.out.println();
}
}
}
private static String getCellValue(Cell cell) {
if (cell == null) return "";
switch (cell.getCellType()) {
case STRING: return cell.getStringCellValue();
case NUMERIC:
if (DateUtil.isCellDateFormatted(cell)) {
return cell.getDateCellValue().toString();
} else {
return String.valueOf(cell.getNumericCellValue());
}
case BOOLEAN: return String.valueOf(cell.getBooleanCellValue());
default: return "";
}
}
}
注意几个关键点
- 文件路径要对:test.xlsx 放在项目根目录或给绝对路径,否则抛 FileNotFoundException
- .xls 用 HSSFWorkbook,.xlsx 用 XSSFWorkbook;统一用 Workbook 接口更灵活(但入门先认准 XSSFWorkbook)
- 空单元格返回 null,调用 getCell() 后务必判空,否则 NPE
- 数字类型要区分日期/普通数字,不然 2024/1/1 可能读成 45292.0,得用 DateUtil 判断
- 记得用 try-with-resources,自动关闭流和 workbook,避免内存泄漏
如果只想读纯文本,不想处理类型?
可以改用 DataFormatter 一行搞定格式化输出(推荐生产环境用):
DataFormatter formatter = new DataFormatter();
String value = formatter.formatCellValue(cell); // 自动按 Excel 显示样式转字符串
基本上就这些。不复杂但容易忽略细节——把依赖加对、空单元格判好、数字类型分清,就能稳稳读出 Excel 内容。
Postman是一套面向API全生命周期的开发与测试平台,可在Mac上发送和调试多种协议请求,管理集合、环境及认证信息,并完成脚本测试、模拟服务、监控、文档发布和团队协作。它适合开发、测试及运维人员使用,提供个人免费方案。
Docker Desktop 是 Docker 官方为 Mac 提供的容器开发环境,集成 Docker Engine、命令行工具、Compose、Build、Kubernetes 与图形化管理界面。
Android Studio 是 Google 面向安卓应用开发提供的官方集成开发环境,基于 IntelliJ IDEA 构建。它整合智能代码编辑、Gradle 构建、界面预览、设备模拟、性能分析、调试测试及 APK 分析等工具。
PixPix 是面向品牌、卖家和内容团队的在线 AI 图片视频创作平台,提供图视频 Agent、无限画布、图片生成、视频生成、自然语言编辑及商品套图、产品精修和带货视频等电商工具。
Postman 是面向 API 全生命周期的开发与协作平台。Windows 桌面版可用于构建和发送 HTTP、GraphQL、gRPC、WebSocket、MQTT 等请求,并提供环境变量、集合、脚本测试、模拟服务、监控、文档及团队工作区等
Docker Desktop 为 Windows 开发者提供集成式容器环境,内置 Docker Engine、命令行工具、Compose、Build 与 Kubernetes 等组件,可在本机完成镜像构建、容器运行、日志查看和资源管理。













