首页 > 文章 > java教程

Java读取Excel简单POI教程

时间：2026-03-06 20:50:43 454浏览收藏

本文手把手教你用 Apache POI 实现 Java 读取 Excel 的最简实践——只需添加一个 Maven 依赖（poi-ooxml），几行代码就能清晰读取 .xlsx 文件的首行标题和第二行数据，同时贴心提醒了路径配置、空单元格判空、数字与日期类型识别、资源自动释放等易踩坑细节，并附上更健壮的 DataFormatter 方案，让初学者零障碍上手、开发者快速落地。

Java 怎么读取 Excel？最简单的 POI 示例

Java 读取 Excel 最简单的方式是用 Apache POI，尤其适合处理 .xls（HSSF）和 .xlsx（XSSF）格式。下面是一个零依赖、直接可跑的入门示例，只读取第一个 sheet 的前几行内容。

添加 Maven 依赖（只需一个）

如果你用 Maven，加这行到 pom.xml 即可（POI 自动包含 commons-collections4、commons-math3 等，不用额外引）：

  org.apache.poi
  poi-ooxml
  5.2.4

读取 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           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           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 内容。

终于介绍完啦！小伙伴们，这篇关于《Java读取Excel简单POI教程》的介绍应该让你收获多多了吧！欢迎大家收藏或分享给更多需要学习的朋友吧~golang学习网公众号也会发布文章相关知识，快来关注吧！

资料下载

编程学习资料下载

精选编程（Golang、Python、Java、C++、JavaScript等）教程、电子书与示例源码，一键打包本地下载学习。

立即下载