当前位置：首页 > 文章列表 > 文章 > java教程 > JavaPOI操作Excel教程：读写表格指南

JavaPOI操作Excel教程：读写表格指南

2026-02-21 10:12:12 0浏览收藏

本文系统介绍了如何使用Apache POI库在Java中高效读写Excel文件，涵盖从Maven依赖引入、.xls与.xlsx格式的兼容性处理，到逐行遍历读取数据、动态创建表格并写入内容的完整流程，同时强调了空指针防护、样式定制、大数据量下的SXSSF性能优化以及资源安全关闭等实战关键点，为开发者提供了一套开箱即用、稳定可靠的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中添加如下依赖：


    org.apache.poi
    poi-ooxml
    5.2.3

这个依赖包含了处理.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();
    }
}