当前位置：首页 > 文章列表 > 文章 > java教程 > Java读取Excel简单POI教程

Java读取Excel简单POI教程

2026-03-06 20:50:43 0浏览收藏

本文手把手教你用 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，避免内存泄漏