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
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 一行搞定格式化输出(推荐生产环境用):
立即学习“Java免费学习笔记(深入)”;
DataFormatter formatter = new DataFormatter();
String value = formatter.formatCellValue(cell); // 自动按 Excel 显示样式转字符串
基本上就这些。不复杂但容易忽略细节——把依赖加对、空单元格判好、数字类型分清,就能稳稳读出 Excel 内容。










