0

0

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

舞夢輝影

舞夢輝影

发布时间:2025-12-29 14:54:09

|

341人浏览过

|

来源于php中文网

原创

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

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 文件,打印第一行标题和第二行数据:

人民网AIGC-X
人民网AIGC-X

国内科研机构联合推出的AI生成内容检测工具

下载

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

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

通义千问
通义千问

阿里巴巴推出的全能AI助手

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
Java Maven专题
Java Maven专题

本专题聚焦 Java 主流构建工具 Maven 的学习与应用,系统讲解项目结构、依赖管理、插件使用、生命周期与多模块项目配置。通过企业管理系统、Web 应用与微服务项目实战,帮助学员全面掌握 Maven 在 Java 项目构建与团队协作中的核心技能。

0

2025.09.15

python中print函数的用法
python中print函数的用法

python中print函数的语法是“print(value1, value2, ..., sep=' ', end=' ', file=sys.stdout, flush=False)”。本专题为大家提供print相关的文章、下载、课程内容,供大家免费下载体验。

192

2023.09.27

python print用法与作用
python print用法与作用

本专题整合了python print的用法、作用、函数功能相关内容,阅读专题下面的文章了解更多详细教程。

19

2026.02.03

string转int
string转int

在编程中,我们经常会遇到需要将字符串(str)转换为整数(int)的情况。这可能是因为我们需要对字符串进行数值计算,或者需要将用户输入的字符串转换为整数进行处理。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

1010

2023.08.02

java中boolean的用法
java中boolean的用法

在Java中,boolean是一种基本数据类型,它只有两个可能的值:true和false。boolean类型经常用于条件测试,比如进行比较或者检查某个条件是否满足。想了解更多java中boolean的相关内容,可以阅读本专题下面的文章。

367

2023.11.13

java boolean类型
java boolean类型

本专题整合了java中boolean类型相关教程,阅读专题下面的文章了解更多详细内容。

42

2025.11.30

c语言中null和NULL的区别
c语言中null和NULL的区别

c语言中null和NULL的区别是:null是C语言中的一个宏定义,通常用来表示一个空指针,可以用于初始化指针变量,或者在条件语句中判断指针是否为空;NULL是C语言中的一个预定义常量,通常用来表示一个空值,用于表示一个空的指针、空的指针数组或者空的结构体指针。

254

2023.09.22

java中null的用法
java中null的用法

在Java中,null表示一个引用类型的变量不指向任何对象。可以将null赋值给任何引用类型的变量,包括类、接口、数组、字符串等。想了解更多null的相关内容,可以阅读本专题下面的文章。

1089

2024.03.01

C# ASP.NET Core微服务架构与API网关实践
C# ASP.NET Core微服务架构与API网关实践

本专题围绕 C# 在现代后端架构中的微服务实践展开,系统讲解基于 ASP.NET Core 构建可扩展服务体系的核心方法。内容涵盖服务拆分策略、RESTful API 设计、服务间通信、API 网关统一入口管理以及服务治理机制。通过真实项目案例,帮助开发者掌握构建高可用微服务系统的关键技术,提高系统的可扩展性与维护效率。

76

2026.03.11

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Excel 教程
Excel 教程

共162课时 | 21.1万人学习

成为PHP架构师-自制PHP框架
成为PHP架构师-自制PHP框架

共28课时 | 2.6万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号