JavaPOI操作Excel教程：读写表格详解

想要在Java中轻松操作Excel表格？这篇**Java操作Excel教程**将带你玩转Apache POI库，实现Excel的读写功能。首先，你需要引入`poi-ooxml`依赖，让你的项目支持.xlsx格式。然后，我们将一步步讲解如何使用`XSSFWorkbook`或`HSSFWorkbook`打开Excel文件，遍历Sheet、Row和Cell，读取表格数据。同时，还会教你如何创建Workbook、Sheet、Row和Cell，设置单元格值，将数据写入Excel文件。本教程还总结了使用POI时需要注意的文件格式兼容性、空指针异常处理、样式设置以及性能优化技巧，助你高效利用POI进行Excel操作，适用于各种业务场景。掌握POI，让你的Java程序也能轻松驾驭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文件最常用的方式是使用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();
    }
}

• 创建Workbook和Sheet
• 创建行和单元格并设置值
• 最后写入到文件并关闭资源

小技巧：写入大量数据时建议使用SXSSF（基于磁盘缓存）避免内存溢出。

四、常见问题与注意事项

在使用POI过程中，可能会遇到一些常见问题，这里列出几个关键点：

• 文件格式不兼容：确保读取和写入时使用正确的类（如XSSF对应.xlsx，HSSF对应.xls）
• 空指针异常：读取时注意判断行或单元格是否为null
• 样式设置：可以通过CellStyle设置字体、背景色、边框等
• 性能问题：大数据量读写时，建议使用SXSSF模式
• 关闭资源：务必在finally块中关闭Workbook和流，避免内存泄漏

基本上就这些。POI虽然功能强大，但用起来并不复杂，只要掌握基本结构和API，就能满足大部分Excel操作需求。

好了，本文到此结束，带大家了解了《JavaPOI操作Excel教程：读写表格详解》，希望本文对你有所帮助！关注golang学习网公众号，给大家分享更多文章知识！