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

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 等,不用额外引):


  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
  • 数字类型要区分日期/普通数字,不然 2025/1/1 可能读成 45292.0,得用 DateUtil 判断
  • 记得用 try-with-resources,自动关闭流和 workbook,避免内存泄漏

如果只想读纯文本,不想处理类型?

可以改用 DataFormatter 一行搞定格式化输出(推荐生产环境用):

DataFormatter formatter = new DataFormatter();
String value = formatter.formatCellValue(cell); // 自动按 Excel 显示样式转字符串

基本上就这些。不复杂但容易忽略细节——把依赖加对、空单元格判好、数字类型分清,就能稳稳读出 Excel 内容。