当前位置:首页 > 文章列表 > 文章 > java教程 > JavaPOI库操作Excel教程详解

JavaPOI库操作Excel教程详解

2025-07-20 15:12:35 0浏览 收藏

想要用Java轻松操作Excel?Apache POI库是你的不二之选!本教程将深入详解如何利用POI库进行Excel文件的读写操作,包括对.xls和.xlsx两种常见格式的支持。首先,我们将介绍如何在Maven项目中引入poi-ooxml依赖,为处理.xlsx文件做好准备。接着,我们将详细讲解如何读取Excel文件,包括创建Workbook对象、遍历Sheet和Row,以及读取Cell内容时的注意事项,例如处理不同类型的单元格和空单元格。此外,我们还将演示如何创建Excel文件,设置单元格内容,并将其输出到文件流。最后,我们将探讨使用POI操作Excel时可能遇到的常见问题,例如兼容性问题、性能优化、空指针异常以及公式计算等,助你掌握POI的核心技巧,提升Excel数据处理效率。

Java操作Excel最常用工具是Apache POI库,支持读写.xls和.xlsx格式。1. 使用Maven添加poi-ooxml依赖处理.xlsx文件或poi处理.xls文件;2. 读取时根据文件类型创建Workbook对象,遍历Sheet和Row并读取Cell内容,注意处理不同类型和空单元格;3. 写入时创建Workbook、Sheet、Row和Cell,设置内容后输出到文件流,并可设置样式及优化性能;4. 注意兼容性、性能优化(如SXSSF模型)、空指针异常处理及公式计算问题。掌握这些基础操作有助于进一步深入应用。

Java如何操作Excel文件?POI库读写教程

Java操作Excel文件最常用的工具是Apache POI库,它支持读写.xls和.xlsx格式的文件。如果你需要用Java处理Excel数据,比如生成报表、导入导出数据等,POI几乎是首选方案。

Java如何操作Excel文件?POI库读写教程

下面我们就来看看怎么用POI来读写Excel文件。


1. 添加POI依赖

在开始编码前,先要确保项目中引入了POI的依赖。如果你使用Maven,可以在pom.xml中添加以下内容:

Java如何操作Excel文件?POI库读写教程
<dependency>
    <groupId>org.apache.poi</groupId>
    <artifactId>poi-ooxml</artifactId>
    <version>5.2.3</version>
</dependency>

这个包包含了处理.xlsx格式文件所需的所有类。如果是旧版.xls文件,则需要引入poi而不是poi-ooxml


2. 读取Excel文件

读取Excel通常是为了提取数据,比如从用户上传的表格中获取信息。POI提供了两种主要类:HSSFWorkbook用于.xls文件,XSSFWorkbook用于.xlsx文件。

Java如何操作Excel文件?POI库读写教程

基本流程如下:

  • 打开文件输入流
  • 创建Workbook对象
  • 遍历Sheet和Row,读取Cell内容

示例代码:

FileInputStream fis = new FileInputStream("data.xlsx");
Workbook workbook = new XSSFWorkbook(fis);
Sheet sheet = workbook.getSheetAt(0);

for (Row row : sheet) {
    for (Cell cell : row) {
        System.out.print(cell.toString() + "\t");
    }
    System.out.println();
}

需要注意的是:

  • 不同类型的单元格(数字、字符串、日期)要用不同的方法获取值,例如getStringCellValue()getNumericCellValue()
  • 空单元格可能会抛异常,建议加判断或使用getCell()时指定Row.MissingCellPolicy.RETURN_BLANK_AS_NULL

3. 写入Excel文件

写入Excel常用于导出数据,比如将数据库查询结果保存为Excel文件。

步骤大致如下:

  • 创建Workbook对象
  • 创建Sheet和Row
  • 设置Cell内容
  • 输出到文件流

示例代码:

Workbook workbook = new XSSFWorkbook();
Sheet sheet = workbook.createSheet("数据表");

Row headerRow = sheet.createRow(0);
Cell cell = headerRow.createCell(0);
cell.setCellValue("姓名");

cell = headerRow.createCell(1);
cell.setCellValue("年龄");

Row dataRow = sheet.createRow(1);
dataRow.createCell(0).setCellValue("张三");
dataRow.createCell(1).setCellValue(25);

FileOutputStream fos = new FileOutputStream("output.xlsx");
workbook.write(fos);
fos.close();

一些小技巧:

  • 可以设置样式,比如字体、颜色、对齐方式
  • 使用AutoFlushable模式可以提高大文件写入性能
  • 写完后记得关闭流,避免资源泄漏

4. 常见问题与注意事项

  • 兼容性问题:POI 3.17之后版本推荐使用poi-ooxml,但要注意JDK版本是否兼容
  • 性能问题:如果数据量特别大,建议使用SXSSF模型,它是基于磁盘缓存的,内存占用低
  • 空指针异常:读取单元格时,建议使用Row.getCell(int, Row.MissingCellPolicy)来避免空指针
  • 公式计算:如果Excel里有公式,读取时不会自动计算,需要调用FormulaEvaluator

基本上就这些。POI功能强大,但也有一些细节容易踩坑,比如类型转换、样式设置、性能优化等。掌握好基础操作后,可以根据具体需求进一步深入学习。

文中关于java,Excel,读写操作,ApachePOI,poi-ooxml的知识介绍,希望对你的学习有所帮助!若是受益匪浅,那就动动鼠标收藏这篇《JavaPOI库操作Excel教程详解》文章吧,也可关注golang学习网公众号了解相关技术文章。

HTML5ReferrerPolicy设置与使用详解HTML5ReferrerPolicy设置与使用详解
上一篇
HTML5ReferrerPolicy设置与使用详解
HTML中footer标签定义网站底部区域
下一篇
HTML中footer标签定义网站底部区域
查看更多
最新文章
查看更多
课程推荐
  • 前端进阶之JavaScript设计模式
    前端进阶之JavaScript设计模式
    设计模式是开发人员在软件开发过程中面临一般问题时的解决方案,代表了最佳的实践。本课程的主打内容包括JS常见设计模式以及具体应用场景,打造一站式知识长龙服务,适合有JS基础的同学学习。
    542次学习
  • GO语言核心编程课程
    GO语言核心编程课程
    本课程采用真实案例,全面具体可落地,从理论到实践,一步一步将GO核心编程技术、编程思想、底层实现融会贯通,使学习者贴近时代脉搏,做IT互联网时代的弄潮儿。
    511次学习
  • 简单聊聊mysql8与网络通信
    简单聊聊mysql8与网络通信
    如有问题加微信:Le-studyg;在课程中,我们将首先介绍MySQL8的新特性,包括性能优化、安全增强、新数据类型等,帮助学生快速熟悉MySQL8的最新功能。接着,我们将深入解析MySQL的网络通信机制,包括协议、连接管理、数据传输等,让
    498次学习
  • JavaScript正则表达式基础与实战
    JavaScript正则表达式基础与实战
    在任何一门编程语言中,正则表达式,都是一项重要的知识,它提供了高效的字符串匹配与捕获机制,可以极大的简化程序设计。
    487次学习
  • 从零制作响应式网站—Grid布局
    从零制作响应式网站—Grid布局
    本系列教程将展示从零制作一个假想的网络科技公司官网,分为导航,轮播,关于我们,成功案例,服务流程,团队介绍,数据部分,公司动态,底部信息等内容区块。网站整体采用CSSGrid布局,支持响应式,有流畅过渡和展现动画。
    484次学习
查看更多
AI推荐
  • 扣子空间(Coze Space):字节跳动通用AI Agent平台深度解析与应用
    扣子-Space(扣子空间)
    深入了解字节跳动推出的通用型AI Agent平台——扣子空间(Coze Space)。探索其双模式协作、强大的任务自动化、丰富的插件集成及豆包1.5模型技术支撑,覆盖办公、学习、生活等多元应用场景,提升您的AI协作效率。
    10次使用
  • 蛙蛙写作:AI智能写作助手,提升创作效率与质量
    蛙蛙写作
    蛙蛙写作是一款国内领先的AI写作助手,专为内容创作者设计,提供续写、润色、扩写、改写等服务,覆盖小说创作、学术教育、自媒体营销、办公文档等多种场景。
    11次使用
  • AI代码助手:Amazon CodeWhisperer,高效安全的代码生成工具
    CodeWhisperer
    Amazon CodeWhisperer,一款AI代码生成工具,助您高效编写代码。支持多种语言和IDE,提供智能代码建议、安全扫描,加速开发流程。
    28次使用
  • 畅图AI:AI原生智能图表工具 | 零门槛生成与高效团队协作
    畅图AI
    探索畅图AI:领先的AI原生图表工具,告别绘图门槛。AI智能生成思维导图、流程图等多种图表,支持多模态解析、智能转换与高效团队协作。免费试用,提升效率!
    53次使用
  • TextIn智能文字识别:高效文档处理,助力企业数字化转型
    TextIn智能文字识别平台
    TextIn智能文字识别平台,提供OCR、文档解析及NLP技术,实现文档采集、分类、信息抽取及智能审核全流程自动化。降低90%人工审核成本,提升企业效率。
    63次使用
微信登录更方便
  • 密码登录
  • 注册账号
登录即同意 用户协议隐私政策
返回登录
  • 重置密码