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

JavaPOI操作Excel教程详解

2025-08-04 17:49:26 0浏览收藏

还在为Java操作Excel烦恼吗？本教程详解如何使用Apache POI库进行Excel表格的读写操作，助力你的Java项目高效处理Excel数据。首先，引入`poi-ooxml`依赖，支持`.xlsx`格式，同时兼容旧版`.xls`格式。文章将详细介绍如何使用`XSSFWorkbook`或`HSSFWorkbook`打开Excel文件，遍历Sheet、Row和Cell读取内容，以及如何创建Workbook、Sheet、Row和Cell，设置单元格值并写入文件。此外，还会重点提示文件格式兼容性、空指针异常处理、样式设置和性能优化等常见问题。掌握POI，轻松应对各种业务场景下的Excel操作需求，让数据处理更高效！

Java操作Excel最常用的方式是使用Apache POI库，1.引入POI依赖，Maven项目添加poi-ooxml依赖；2.读取Excel使用XSSFWorkbook或HSSFWorkbook打开文件，遍历Sheet、Row和Cell读取内容并关闭资源；3.写入Excel创建Workbook、Sheet、Row和Cell，设置单元格值并写入文件；4.注意文件格式兼容性、空指针异常、样式设置、性能优化及资源关闭等问题。POI功能强大且适用性强，适用于大多数业务场景。

Java如何操作Excel文件 Java使用POI读写电子表格教程

Java操作Excel文件最常用的方式是使用Apache POI库，它支持.xls和.xlsx格式，功能强大，适用性强。如果你需要从Java程序中读取或写入Excel文件，POI是一个非常合适的选择。

下面我们就来一步步看看如何使用POI来读写Excel文件，适用于大多数业务场景。

一、引入POI依赖

在开始编码之前，首先要确保项目中已经引入了Apache POI的依赖。如果你使用的是Maven项目，可以在pom.xml中添加如下依赖：

<dependency>
    <groupId>org.apache.poi</groupId>
    <artifactId>poi-ooxml</artifactId>
    <version>5.2.3</version>
</dependency>

这个依赖包含了处理.xlsx格式所需的所有类。如果你还需要处理旧版.xls格式，也可以单独引入poi依赖。

二、使用POI读取Excel文件

读取Excel文件是常见的需求，比如导入数据、分析报表等。以下是一个简单的读取.xlsx文件的示例：

import org.apache.poi.ss.usermodel.*;
import org.apache.poi.xssf.usermodel.XSSFWorkbook;

import java.io.File;
import java.io.FileInputStream;
import java.io.IOException;

public class ExcelReader {
    public static void main(String[] args) throws IOException {
        FileInputStream fis = new FileInputStream(new File("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();
        }

        workbook.close();
        fis.close();
    }
}

使用XSSFWorkbook打开.xlsx文件
遍历Sheet中的每一行和每个单元格
注意关闭资源（Workbook和FileInputStream）

小提示：如果读取的是.xls文件，可以使用HSSFWorkbook代替XSSFWorkbook。

三、使用POI写入Excel文件

写入Excel文件通常用于导出数据或生成报表。POI提供了非常灵活的API来创建和操作单元格内容。

import org.apache.poi.ss.usermodel.*;
import org.apache.poi.xssf.usermodel.XSSFWorkbook;

import java.io.FileOutputStream;
import java.io.IOException;

public class ExcelWriter {
    public static void main(String[] args) throws IOException {
        Workbook workbook = new XSSFWorkbook();
        Sheet sheet = workbook.createSheet("Sheet1");

        Row headerRow = sheet.createRow(0);
        Cell headerCell = headerRow.createCell(0);
        headerCell.setCellValue("姓名");
        headerRow.createCell(1).setCellValue("年龄");

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

        try (FileOutputStream fos = new FileOutputStream("output.xlsx")) {
            workbook.write(fos);
        }

        workbook.close();
    }
}