从入门到精通详解Java Apache POI操作Excel的实战教程

 更新时间:2026年05月30日 08:51:26   作者:小当家.105  
在Java开发中,Excel文件处理是一项常见且重要的技能,Apache POI作为Java操作Excel的经典库,提供了强大的API支持,本文从基础IO流操作Excel的局限性入手,本文详细介绍了Apache POI的核心概念,依赖配置,以及实战案例

一、Excel操作方式概述

在Java开发中,操作Excel文件主要有两种方式:

  1. Apache POI:Apache基金会的开源项目,用于操作Microsoft Office格式文件,包括Excel。
  2. EasyExcel:阿里巴巴开源的Excel处理框架,是对POI的封装,简化了Excel操作。

本文将重点介绍Apache POI的使用方法,帮助大家快速掌握Java操作Excel的核心技能。

二、Java基础IO流操作Excel的局限性

使用Java基础IO流可以实现文件的复制,但无法直接以字符串形式读取Excel文件中的数据,读取结果会是乱码或无法解析的字符。

// 错误演示:用字符流读取Excel文件
import java.io.FileReader;
import java.io.BufferedReader;
import java.io.IOException;

public class WrongExcelReaderDemo {
    public static void main(String[] args) {
        // 待读取的Excel文件路径(.xls或.xlsx均可,都会报错/乱码)
        String excelFilePath = "src/test/java/Demo.xlsx";
        
        // 声明字符流对象
        FileReader fileReader = null;
        BufferedReader bufferedReader = null;

        try {
            // 1. 初始化字符流,尝试读取Excel文件
            fileReader = new FileReader(excelFilePath);
            bufferedReader = new BufferedReader(fileReader);

            // 2. 按行读取文件内容
            String line;
            System.out.println("尝试用字符流读取Excel文件内容:");
            while ((line = bufferedReader.readLine()) != null) {
                // 3. 输出读取到的内容(会是乱码或无法解析的字符)
                System.out.println(line);
            }

        } catch (IOException e) {
            // 捕获IO异常(可能直接抛出文件读取失败,或读取过程中报错)
            e.printStackTrace();
        } finally {
            // 4. 手动关闭流(避免资源泄露,即使读取失败也执行)
            try {
                if (bufferedReader != null) {
                    bufferedReader.close();
                }
                if (fileReader != null) {
                    fileReader.close();
                }
            } catch (IOException e) {
                e.printStackTrace();
            }
        }
    }
}

不能直接使用IO,虽然能用二进制的形式实现文件转移这一类行为.

三、Apache POI入门

3.1 POI简介

Apache POI(Poor Obfuscation Implementation)是Apache基金会的开源项目,提供了Java API来处理Microsoft Office格式的文件,包括Excel、Word、PowerPoint等。

3.2 Excel文件格式

Excel有两种主要文件格式:

  • .xls:Excel 2003及之前版本的文件格式,最多包含65536行,256列。
  • .xlsx:Excel 2007及之后版本的文件格式,最多包含1048576行,16384列。

3.3 导入POI依赖

不同版本的Excel文件需要使用不同的POI依赖:

<!-- POI依赖(xls格式) -->
<dependency>
    <groupId>org.apache.poi</groupId>
    <artifactId>poi</artifactId>
    <version>5.2.4</version>
</dependency>
<!-- POI依赖(xlsx格式) -->
<dependency>
    <groupId>org.apache.poi</groupId>
    <artifactId>poi-ooxml</artifactId>
    <version>5.2.4</version>
</dependency>

四、POI写入Excel文件

下面我们通过一个实例来学习如何使用POI写入Excel文件:

4.1 核心API说明

  • Workbook:工作簿接口,代表整个Excel文件
    • HSSFWorkbook:对应.xls格式
    • XSSFWorkbook:对应.xlsx格式
  • Sheet:工作表,一个Workbook可以包含多个Sheet
  • Row:行,一个Sheet可以包含多个Row
  • Cell:单元格,一个Row可以包含多个Cell

4.2 写入Excel示例

import org.apache.poi.hssf.usermodel.HSSFWorkbook;
import org.apache.poi.ss.usermodel.*;
import java.io.FileOutputStream;
import java.io.IOException;

// 生成实习记录Excel文件(.xls格式)
public class Test {
    public static void main(String[] args) throws Exception {
        // 1. 创建Workbook(HSSFWorkbook对应.xls,XSSFWorkbook对应.xlsx)
        Workbook workbook = new HSSFWorkbook();
        
        // 2. 创建Sheet,命名为「实习记录」(核心修改点1)
        Sheet sheet = workbook.createSheet("实习记录");
        
        // 3. 创建表头行(第一行,索引0)
        Row headerRow = sheet.createRow(0);
        // 表头单元格:姓名、性别、工作、公司
        headerRow.createCell(0).setCellValue("姓名");
        headerRow.createCell(1).setCellValue("性别");
        headerRow.createCell(2).setCellValue("工作");
        headerRow.createCell(3).setCellValue("公司");
        
        // 4. 创建数据行(第二行,索引1),填充指定数据(核心修改点2)
        Row dataRow = sheet.createRow(1);
        dataRow.createCell(0).setCellValue("小当家");  // 姓名
        dataRow.createCell(1).setCellValue("男");      // 性别
        dataRow.createCell(2).setCellValue("后端开发");// 工作
        dataRow.createCell(3).setCellValue("xxx");     // 公司

        // 5. 自动调整列宽(优化显示效果)
        for (int i = 0; i < 4; i++) {
            sheet.autoSizeColumn(i);
        }
        
        // 6. 写入文件并关闭资源
        try (FileOutputStream fos = new FileOutputStream("D:\\实习记录.xls")) {
            workbook.write(fos);
            System.out.println("实习记录Excel生成成功!路径:D:\\实习记录.xls");
        } catch (IOException e) {
            e.printStackTrace();
        } finally {
            workbook.close();
        }
    }
}

4.3 运行结果

运行上述代码后,会在D盘根目录生成一个名为"实习记录.xls"的Excel文件:

这里的报错是日志依赖,无视即可,不影响demo演示

五、POI读取Excel文件

5.1 基本读取示例

import org.apache.poi.hssf.usermodel.HSSFWorkbook;
import org.apache.poi.ss.usermodel.*;
import java.io.FileInputStream;
import java.io.InputStream;

public class TestRead {
    public static void main(String[] args) throws Exception {
        // 获取文件的数据流(实习记录Excel路径)
        InputStream inputStream = new FileInputStream("D:\\实习记录.xls");
        
        // 创建文件对象(仅支持.xls格式)
        Workbook workbook = new HSSFWorkbook(inputStream);
        
        // 获取Sheet(按索引取第一个Sheet)
        Sheet sheet = workbook.getSheetAt(0);
        
        // ========== 读取小当家的信息 ==========
        // 读取第二行(数据行,索引1):第一行是表头(索引0)
        Row dataRow = sheet.getRow(1);
        
        // 读取“姓名”列(第二行第一列,索引0)
        Cell nameCell = dataRow.getCell(0);
        String name = nameCell.getStringCellValue();
        
        // 读取“性别”列(第二行第二列,索引1)
        Cell genderCell = dataRow.getCell(1);
        String gender = genderCell.getStringCellValue();
        
        // 读取“工作”列(第二行第三列,索引2)
        Cell jobCell = dataRow.getCell(2);
        String job = jobCell.getStringCellValue();
        
        // 读取“公司”列(第二行第四列,索引3)
        Cell companyCell = dataRow.getCell(3);
        String company = companyCell.getStringCellValue();
        
        // 打印读取结果
        System.out.println("姓名:" + name);
        System.out.println("性别:" + gender);
        System.out.println("工作:" + job);
        System.out.println("公司:" + company);
        
        // 关闭流
        inputStream.close();
    }
}

5.2 运行结果

5.3 处理不同类型的单元格

在实际开发中,Excel单元格可能包含不同类型的数据(字符串、数字、日期等)。如果直接使用getStringCellValue()读取数字类型的单元格,会报错。因此,我们需要根据单元格类型进行不同的处理:

import org.apache.poi.hssf.usermodel.HSSFWorkbook;
import org.apache.poi.ss.usermodel.*;
import java.io.FileInputStream;
import java.io.InputStream;

public class TestRead {
    public static void main(String[] args) throws Exception {
        // 获取文件的数据流(实习记录Excel路径)
        InputStream inputStream = new FileInputStream("D:\\实习记录.xls");
        
        // 创建文件对象(仅支持.xls格式)
        Workbook workbook = new HSSFWorkbook(inputStream);
        
        // 获取Sheet(按索引取第一个Sheet)
        Sheet sheet = workbook.getSheetAt(0);
        
        // ========== 读取小当家的信息 ==========
        // 读取第二行(数据行,索引1):第一行是表头(索引0)
        Row dataRow = sheet.getRow(1);
        
        // 读取“姓名”列(第二行第一列,索引0)
        Cell nameCell = dataRow.getCell(0);
        String name = nameCell.getStringCellValue();
        
        // 读取“性别”列(第二行第二列,索引1)
        Cell genderCell = dataRow.getCell(1);
        String gender = genderCell.getStringCellValue();
        
        // 读取“工作”列(第二行第三列,索引2)
        Cell jobCell = dataRow.getCell(2);
        if (jobCell.getCellType() == CellType.STRING) {
            String job = jobCell.getStringCellValue();
        } else if (jobCell.getCellType() == CellType.NUMERIC) {
            double jobNum = jobCell.getNumericCellValue();
            String job = String.valueOf(jobNum);
        }
        
        // 读取“公司”列(第二行第四列,索引3)
        Cell companyCell = dataRow.getCell(3);
        if (companyCell.getCellType() == CellType.STRING) {
            String company = companyCell.getStringCellValue();
        } else if (companyCell.getCellType() == CellType.NUMERIC) {
            double companyNum = companyCell.getNumericCellValue();
            String company = String.valueOf(companyNum);
        }
        
        // 打印读取结果
        System.out.println("姓名:" + name);
        System.out.println("性别:" + gender);
        System.out.println("工作:" + job);
        System.out.println("公司:" + company);
        
        // 关闭流
        inputStream.close();
    }
}

六、总结

通过本文的学习,我们了解了:

  1. Java操作Excel的两种主要方式:POI和EasyExcel
  2. 基础IO流操作Excel的局限性
  3. POI的核心API和使用方法
  4. 如何使用POI写入Excel文件
  5. 如何使用POI读取Excel文件
  6. 如何处理不同类型的Excel单元格

POI作为Java操作Excel的经典库,功能强大但使用相对复杂。在实际开发中,如果需要处理大量数据或追求更简洁的代码,可以考虑使用EasyExcel等封装库。

到此这篇关于从入门到精通详解Java Apache POI操作Excel的实战教程的文章就介绍到这了,更多相关Java Apache POI操作Excel内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家!

相关文章

  • Java SPI机制原理与实战技巧

    Java SPI机制原理与实战技巧

    这段文章深入解析了JavaSPI机制原理与实战,涵盖基本原理、代码实战及优化方案,重点介绍了资源管理、异常处理、日志规范和单元测试的最佳实践,助你写出高质量代码,感兴趣的朋友一起看看吧
    2026-06-06
  • Spring Boot如何配置yml配置文件定义集合、数组和Map

    Spring Boot如何配置yml配置文件定义集合、数组和Map

    这篇文章主要介绍了Spring Boot 优雅配置yml配置文件定义集合、数组和Map,包括Spring Boot yml配置文件定义基本数据类型和引用数据类型的方式,需要的朋友可以参考下
    2023-10-10
  • Spring AI集成DeepSeek实现流式输出的操作方法

    Spring AI集成DeepSeek实现流式输出的操作方法

    本文介绍了如何在SpringBoot中使用Sse(Server-SentEvents)技术实现流式输出,后端使用SpringMVC中的SseEmitter对象,前端使用EventSource对象监听SSE接口并展示数据流,通过这种方式可以提升用户体验,避免大模型响应速度慢的问题,感兴趣的朋友一起看看吧
    2025-03-03
  • Netty + ZooKeeper 实现简单的服务注册与发现

    Netty + ZooKeeper 实现简单的服务注册与发现

    服务注册和发现一直是分布式的核心组件。本文介绍了借助 ZooKeeper 做注册中心,如何实现一个简单的服务注册和发现。,需要的朋友可以参考下
    2019-06-06
  • SpringBoot自定义注解验证枚举的实现

    SpringBoot自定义注解验证枚举的实现

    本文主要介绍了SpringBoot自定义注解验证枚举的实现,数据校验,需要对枚举类型的数据传参,进行数据校验,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
    2024-01-01
  • Java 静态机制之静态变量、方法、代码块与类加载深入理解

    Java 静态机制之静态变量、方法、代码块与类加载深入理解

    本文全面解析了Java中static关键字的特性与应用,静态机制使成员与类本身关联,包括静态变量(存储在方法区,所有对象共享)、静态方法(可通过类名直接调用,不能访问实例成员)和静态代码块(类加载时执行),感兴趣的朋友跟随小编一起看看吧
    2025-11-11
  • java并发编程专题(四)----浅谈(JUC)Lock锁

    java并发编程专题(四)----浅谈(JUC)Lock锁

    这篇文章主要介绍了java并发编程(JUC)Lock锁的相关内容,文中讲解非常细致,代码帮助大家更好的理解和学习,感兴趣的朋友可以了解下
    2020-06-06
  • Jenkins安装以及邮件配置详解

    Jenkins安装以及邮件配置详解

    这篇文章主要介绍了Jenkins安装以及邮件配置相关问题,并通过图文给大家做了详细讲解步骤,需要的朋友参考下吧。
    2017-12-12
  • Spring根据XML配置文件注入属性的方法

    Spring根据XML配置文件注入属性的方法

    下面小编就为大家带来一篇Spring根据XML配置文件注入属性的方法。小编觉得挺不错的,现在就分享给大家,也给大家做个参考。一起跟随小编过来看看吧
    2017-11-11
  • Java 设计模式之责任链模式及异步责任链详解

    Java 设计模式之责任链模式及异步责任链详解

    顾名思义,责任链模式(Chain of Responsibility Pattern)为请求创建了一个接收者对象的链。这种模式给予请求的类型,对请求的发送者和接收者进行解耦。这种类型的设计模式属于行为型模式
    2021-11-11

最新评论