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

发布时间 - 2025-12-29 00:00:00    点击率:
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 内容。


# excel  # java  # apache  # ai  # switch  # stream  # 格式化输出 


相关栏目: 【 网站优化151355 】 【 网络推广146373 】 【 网络技术251813 】 【 AI营销90571


相关推荐: PHP 实现电台节目表的智能时间匹配与今日/明日轮播逻辑  如何彻底删除建站之星生成的Banner?  Python进程池调度策略_任务分发说明【指导】  JavaScript如何实现类型判断_typeof和instanceof有什么区别  Win11怎么关闭专注助手 Win11关闭免打扰模式设置【操作】  Laravel如何发送邮件和通知_Laravel邮件与通知系统发送步骤  EditPlus中的正则表达式实战(6)  原生JS获取元素集合的子元素宽度实例  如何制作新型网站程序文件,新型止水鱼鳞网要拆除吗?  Midjourney怎么调整光影效果_Midjourney光影调整方法【指南】  微博html5版本怎么弄发超话_超话进入入口及发帖格式要求【教程】  成都网站制作公司哪家好,四川省职工服务网是做什么用?  Laravel怎么自定义错误页面_Laravel修改404和500页面模板  百度输入法全感官ai怎么关 百度输入法全感官皮肤关闭  悟空浏览器如何设置小说背景色_悟空浏览器背景色设置【方法】  Laravel如何实现多表关联模型定义_Laravel多对多关系及中间表数据存取【方法】  php打包exe后无法访问网络共享_共享权限设置方法【教程】  Android okhttputils现在进度显示实例代码  Laravel如何处理异常和错误?(Handler示例)  如何快速打造个性化非模板自助建站?  如何挑选高效建站主机与优质域名?  简单实现Android验证码  Laravel的契約(Contracts)是什么_深入理解Laravel Contracts与依赖倒置  北京网站制作费用多少,建立一个公司网站的费用.有哪些部分,分别要多少钱?  儿童网站界面设计图片,中国少年儿童教育网站-怎么去注册?  Laravel如何发送系统通知?(Notification渠道示例)  长沙企业网站制作哪家好,长沙水业集团官方网站?  电视网站制作tvbox接口,云海电视怎样自定义添加电视源?  Laravel怎么进行浏览器测试_Laravel Dusk自动化浏览器测试入门  佛山企业网站制作公司有哪些,沟通100网上服务官网?  Laravel如何实现用户角色和权限系统_Laravel角色权限管理机制  Laravel Seeder怎么填充数据_Laravel数据库填充器的使用方法与技巧  Bootstrap整体框架之JavaScript插件架构  深圳网站制作设计招聘,关于服装设计的流行趋势,哪里的资料比较全面?  Laravel N+1查询问题如何解决_Eloquent预加载(Eager Loading)优化数据库查询  如何在阿里云域名上完成建站全流程?  如何用AI帮你把自己的生活经历写成一个有趣的故事?  JavaScript常见的五种数组去重的方式  Python面向对象测试方法_mock解析【教程】  Laravel中的Facade(门面)到底是什么原理  Laravel如何生成API文档?(Swagger/OpenAPI教程)  Laravel怎么配置S3云存储驱动_Laravel集成阿里云OSS或AWS S3存储桶【教程】  Laravel Livewire是什么_使用Laravel Livewire构建动态前端界面  油猴 教程,油猴搜脚本为什么会网页无法显示?  如何用虚拟主机快速搭建网站?详细步骤解析  如何在自有机房高效搭建专业网站?  php增删改查怎么学_零基础入门php数据库操作必知基础【教程】  做企业网站制作流程,企业网站制作基本流程有哪些?  Laravel的Blade指令怎么自定义_创建你自己的Laravel Blade Directives  原生JS实现图片轮播切换效果