POI - EasyExcal 操作

旧梦453

407人浏览 · 2026-03-21 18:04:55

旧梦453 · 2026-03-21 18:04:55 发布

#创作灵感#

最近使用Java操作读写excal文件多了。使用了这些工具就想着分享一下。

这里写了一个demo样例。分别对POI与Easy-Excal两种工具的使用来操作excal文件。

POI介绍

Apache POI 是一个流行的 Java 库，用于处理 Microsoft Office 格式文件，包括 Excel。以下是使用 POI 读写 Excel 文件的示例代码。

结构：

HSSF 提供读写Microsoft Excel格式档案的功能。
XSSF 提供读写Microsoft Excel OOXML格式档案的功能。
HWPF 提供读写Microsoft Word格式档案的功能。
HSLF 提供读写Microsof PowerPoint 格式档案的功能。
HDGF 提供读写Microsoft Visio格式档案的功能。

首先需要引入POI的依赖。值得注意的是。excal文件分为.xls文件与.xlsx文件。这是两种不同的文件格式。所以需要引入不同的依赖。分别用03与07代替。之所以用这个表示，如下表：

版本对应关系

简称	完整格式	Office版本	推出年份	文件扩展名
03	Excel 97-2003	Office 2003及之前	1997-2003	`.xls`
07	Excel 2007+	Office 2007及之后	2007年	`.xlsx`

.xls文件：它最多支持65536行，最大列数：256列的数据。
.xlsx文件：它理论上支持1048576行，最大列数：16384列数据。
显然.xlsx文件支持的数据量更多一些。

两种格式就需要不同的操作工具对齐进行操作。引入依赖需要两种：

<!--xls(03)-->
<dependency>
     <groupId>org.apache.poi</groupId>
     <artifactId>poi</artifactId>
     <version>3.9</version>
</dependency>

<!--xlsx(07)-->
<dependency>
     <groupId>org.apache.poi</groupId>
     <artifactId>poi-ooxml</artifactId>
     <version>3.9</version>
</dependency>

在编写代码之前。我们要清楚excal文件的几种术语。我用一张图对其进行解释。

1.工作簿、2.工作表、3.行、4.列。

写入 Excel 文件操作 (03版本)

/**
 * @author zhy
 * @version 1.0
 * @description: POI 操作 excal 文件；03版本
 * @date 2026/3/20 22:56
 */
public class ExcalWriteTest03 {

    // 保存文件路径
    static String PATH = "D:\\code\\Java\\POI-Project\\POI-Project\\";

    public static void main(String[] args) throws IOException  {
        testWrite03();
    }

    public static void testWrite03() throws IOException {
        Workbook workbook = new HSSFWorkbook();
        // 2、创建一个工作表 (默认Sheet表)
        Sheet sheet = workbook.createSheet("Sheet1");
        // 3、创建一个行 Row row1
        Row row1 = sheet.createRow(0);
        // 4、创建一个单元格 Cell cell11
        // (1,1)
        Cell cell11 = row1.createCell(0);
        cell11.setCellValue("今日阅读量");
        // (1,2)
        Cell cell12 = row1.createCell(1);
        cell12.setCellValue(666);

        // 第二行(2,1)
        Row row2 = sheet.createRow(1);
        Cell cell21 = row2.createCell(0);
        cell21.setCellValue("统计时间");

        //(2,2)
        Cell cell22 = row2.createCell(1);
        String time = new DateTime().toString("yyyy-MM-dd HH:mm:ss");
        cell22.setCellValue(time);

        // 使用IO流生成一张表，03版本需要xls结尾。
        FileOutputStream fileOutputStream = new FileOutputStream(PATH + "03版本写入操作.xls");

        // 输出操作
        workbook.write(fileOutputStream);

        // 关闭流
        fileOutputStream.close();

        System.out.println("xls文件生成完毕！");
    }

}

03效果展示：

写入 Excel 文件操作 (07版本)

/**
 * @author zhy
 * @version 1.0
 * @description: POI 操作 excal 文件；07版本
 * @date 2026/3/20 22:56
 */
public class ExcalWriteTest07 {

    // 保存文件路径
    static String PATH = "D:\\code\\Java\\POI-Project\\POI-Project\\";

    public static void main(String[] args) throws IOException  {
        testWrite07();
    }


    public static void testWrite07() throws IOException {
        Workbook workbook = new XSSFWorkbook();
        // 2、创建一个工作表 (默认Sheet表)
        Sheet sheet = workbook.createSheet("Sheet1");
        // 3、创建一个行 Row row1
        Row row1 = sheet.createRow(0);
        // 4、创建一个单元格 Cell cell11
        // (1,1)
        Cell cell11 = row1.createCell(0);
        cell11.setCellValue("今日阅读量");
        // (1,2)
        Cell cell12 = row1.createCell(1);
        cell12.setCellValue(666);

        // 第二行(2,1)
        Row row2 = sheet.createRow(1);
        Cell cell21 = row2.createCell(0);
        cell21.setCellValue("统计时间");

        //(2,2)
        Cell cell22 = row2.createCell(1);
        String time = new DateTime().toString("yyyy-MM-dd HH:mm:ss");
        cell22.setCellValue(time);

        // 使用IO流生成一张表，07版本需要xlsx结尾。
        FileOutputStream fileOutputStream = new FileOutputStream(PATH + "07版本写入操作.xlsx");

        // 输出操作
        workbook.write(fileOutputStream);

        // 关闭流
        fileOutputStream.close();

        System.out.println("xlsx文件生成完毕！");
    }

}

07效果展示：

总结：03与07除了使用了两个不同的操作对象，还需要更改文件的后缀名。同时这是小文件的操作，下面介绍大文件的操作。

在数据量比较大的时候，也就是批量导入的时候。使用上面的方式就不行了。所以需要大文件写入的操作对象。如下：

大文件写入（03版本）

HSSFWorkbook
缺点：最多只能处理65536行，否则会抛出异常。
Invalid row number (65536) outside allowable range (0..65535)

优点：过程中写入缓存，不操作磁盘，最后一次性写入磁盘，速度快。

/**
 * @author zhy
 * @version 1.0
 * @description: POI 操作 excal 文件；03版本
 * @date 2026/3/20 22:56
 */
public class ExcalWriteTest03 {

    // 保存文件路径
    static String PATH = "D:\\code\\Java\\POI-Project\\POI-Project\\";

    public static void main(String[] args) throws IOException {
        testWrite03BigData();
    }
    public static void testWrite03BigData() throws IOException {
        // 开始时间
        long start = System.currentTimeMillis();
        Workbook workbook = new HSSFWorkbook();
        // 2、创建一个工作表 (默认Sheet表)
        Sheet sheet = workbook.createSheet("Sheet1");
        // 写入数据 一旦rowNum 为 65537 则会报错 超过行数最大值
        for (int rowNum = 0; rowNum < 65536; rowNum++) {
            Row row = sheet.createRow(rowNum);
            for (int cellNum = 0; cellNum < 10; cellNum++) {
                Cell cell = row.createCell(cellNum);
                cell.setCellValue(cellNum);
            }
        }
        // 使用IO流生成一张表，03版本需要xls结尾。
        FileOutputStream fileOutputStream = new FileOutputStream(PATH + "大文件03版本写入操作.xls");
        // 输出操作
        workbook.write(fileOutputStream);
        // 关闭流
        fileOutputStream.close();
        long end = System.currentTimeMillis();
        System.out.println("大文件xls文件生成完毕！耗时：" + (double) (end - start) / 1000);

    }
}

展示效果：

大文件写入（07版本）

慢速写入

XSSFWorkbook
缺点：写数据时速度非常慢，非常耗内存，也会发生内存溢出（OOM），如100万条。
优点：可以写较大的数据量，如20万条。

/**
 * @author zhy
 * @version 1.0
 * @description: POI 操作 excal 文件；07版本
 * @date 2026/3/20 22:56
 */
public class ExcalWriteTest07 {

    // 保存文件路径
    static String PATH = "D:\\code\\Java\\POI-Project\\POI-Project\\";

    public static void main(String[] args) throws IOException {
        testWrite07BigData();
    }
    public static void testWrite03BigData() throws IOException {
        // 开始时间
        long start = System.currentTimeMillis();
        Workbook workbook = new XSSFWorkbook();
        // 2、创建一个工作表 (默认Sheet表)
        Sheet sheet = workbook.createSheet("Sheet1");
        // 写入数据 使用XSSFWorkbook之后，超过65536也不会报错。
        for (int rowNum = 0; rowNum < 65537; rowNum++) {
            Row row = sheet.createRow(rowNum);
            for (int cellNum = 0; cellNum < 10; cellNum++) {
                Cell cell = row.createCell(cellNum);
                cell.setCellValue(cellNum);
            }
        }
        // 使用IO流生成一张表，07版本需要xlsx结尾。
        FileOutputStream fileOutputStream = new FileOutputStream(PATH + "大文件07版本写入操作.xls");
        // 输出操作
        workbook.write(fileOutputStream);
        // 关闭流
        fileOutputStream.close();
        long end = System.currentTimeMillis();
        System.out.println("大文件xlsx文件生成完毕！耗时：" + (double) (end - start) / 1000);

    }
}

效果展示：但是这种方式会比较慢。所以我们用下面这种方式。

快速写入

SXSSFWorkbook
优点：可以写非常大的数据量，如100万条甚至更多条，写数据速度快，占用更少的内存。
但是写入过程中会产生临时文件，需要清理临时文件。
默认由100条记录被保存在内存中，如果超过这数量，则最前面的数据被写入临时文件如果想自定义内存中数据的数量，可以使用new SXSSFWorkbook(数量)

/**
 * @author zhy
 * @version 1.0
 * @description: POI 操作 excal 文件；07版本
 * @date 2026/3/20 22:56
 */
public class ExcalWriteTest07SXSSF {

    // 保存文件路径
    static String PATH = "D:\\code\\Java\\POI-Project\\POI-Project\\";

    public static void main(String[] args) throws IOException {
        testWrite07BigDataSXSSF();
    }

    // 加速版
    public static void testWrite07BigDataSXSSF() throws IOException {
        // 开始时间
        long start = System.currentTimeMillis();
        Workbook workbook = new SXSSFWorkbook();
        // 2、创建一个工作表 (默认Sheet表)
        Sheet sheet = workbook.createSheet("Sheet1");
        // 写入数据
        for (int rowNum = 0; rowNum < 100007; rowNum++) {
            Row row = sheet.createRow(rowNum);
            for (int cellNum = 0; cellNum < 10; cellNum++) {
                Cell cell = row.createCell(cellNum);
                cell.setCellValue(cellNum);
            }
        }
        // 使用IO流生成一张表，07版本需要xlsx结尾。
        FileOutputStream fileOutputStream = new FileOutputStream(PATH + "加速版大文件07版本写入操作.xls");
        // 输出操作
        workbook.write(fileOutputStream);
        // 关闭流
        fileOutputStream.close();
        // 清除临时文件!
        ((SXSSFWorkbook)workbook).dispose();

        long end = System.currentTimeMillis();
        System.out.println("加速版大文件xlsx文件生成完毕！耗时：" + (double) (end - start) / 1000);

    }
}

效果展示：这种方式十万条数据花了不到一秒钟。特别注意，这种方式需要将临时文件去除。

读取 Excel 文件操作 (03版本)

public class ExcalReadTest {

    // 读取文件路径
    static String PATH = "D:\\code\\Java\\POI-Project\\POI-Project\\";

    public static void main(String[] args) throws Exception {
        testRead03();
    }
    public static void testRead03() throws Exception {
        // 获取文件流
        FileInputStream inputStream = new FileInputStream(PATH + "03版本读取操作.xls");
        // 1、创建一个工作簿。使用excel能操作的这边他都可以操作!
        Workbook workbook = new HSSFWorkbook(inputStream);
        // 2、得到表
        Sheet sheet = workbook.getSheetAt(0);
        // 3、得到行
        Row row = sheet.getRow(0);
        // 4、得到列
        Cell cell = row.getCell(1);
        // 读取值的时候，一定需要注意类型!
        // getStringcellvalue 字符串类型 getNumericCellValue 获取数字类型
        // System.out.println(cell.getStringCellValue();
        System.out.println(cell.getNumericCellValue());
        inputStream.close();
    }
}

读取 Excel 文件操作 (07版本)

public class ExcalReadTest {

    // 读取文件路径
    static String PATH = "D:\\code\\Java\\POI-Project\\POI-Project\\";

    public static void main(String[] args) throws Exception {
        testRead07();
    }

    public static void testRead07() throws Exception {
        // 获取文件流
        FileInputStream inputStream = new FileInputStream(PATH + "07版本读取操作.xlsx");
        // 1、创建一个工作簿。使用excel能操作的这边他都可以操作!
        Workbook workbook = new XSSFWorkbook(inputStream);
        // 2、得到表
        Sheet sheet = workbook.getSheetAt(0);
        // 3、得到行
        Row row = sheet.getRow(0);
        // 4、得到列
        Cell cell = row.getCell(1);
        // 读取值的时候，一定需要注意类型!
        // getStringcellvalue 字符串类型 getNumericCellValue 获取数字类型
        // System.out.println(cell.getStringCellValue();
        System.out.println(cell.getNumericCellValue());
        inputStream.close();
    }
}

注意：两种读取方式都需要判断excal表格中的值的数据类型。否则会读取失败！

解决任意读取类型数据

这里我封装了一个判断类型的方法。getCellValue


/**
 * @author zhy
 * @version 1.0
 * @description: TODO
 * @date 2026/3/21 02:34
 */
public class ExcalReadTest {

    // 读取文件路径
    static String PATH = "D:\\code\\Java\\POI-Project\\POI-Project\\";

    public static void main(String[] args) throws Exception {
        testRead03_type();
    }
  
    public static void testRead03_type() throws Exception {
        // 获取文件流
        FileInputStream inputStream = new FileInputStream(PATH + "03数据表.xls");
        // 创建一个工作簿
        Workbook workbook = new HSSFWorkbook(inputStream);
        Sheet sheet = workbook.getSheetAt(0);

        // 获取标题内容
        Row rowTitle = sheet.getRow(0);
        if (rowTitle != null) {
            // 获取第一行所有的列
            int cellCount = rowTitle.getPhysicalNumberOfCells();
            for (int cellNum = 0; cellNum < cellCount; cellNum++) {
                Cell cell = rowTitle.getCell(cellNum);
                // 使用封装的方法获取值
                String cellValue = getCellValue(workbook, cell);
                System.out.print(cellValue + " | ");
            }
            System.out.println();
        }

        // 获取表中的内容
        int rowCount = sheet.getPhysicalNumberOfRows();
        for (int rowNum = 1; rowNum < rowCount; rowNum++) {
            Row rowData = sheet.getRow(rowNum);
            if (rowData != null) {
                // 读取列
                int cellCount = rowTitle.getPhysicalNumberOfCells();
                for (int cellNum = 0; cellNum < cellCount; cellNum++) {
                    Cell cell = rowData.getCell(cellNum);
                    // 使用封装的方法获取值
                    String cellValue = getCellValue(workbook, cell);
                    System.out.print("[" + (rowNum + 1) + "," + (cellNum + 1) + "]" + cellValue + " | ");
                }
                System.out.println();
            }
        }
        // 关闭流
        inputStream.close();
    }

    /**
     * 根据单元格类型获取对应的值
     * @param workbook 工作簿对象
     * @param cell 单元格对象
     * @return 单元格的值（以字符串形式返回）
     */
    public static String getCellValue(Workbook workbook, Cell cell) {
        if (cell == null) {
            return "";
        }

        // 获取单元格类型
        int cellType = cell.getCellType();

        // 根据不同类型处理
        switch (cellType) {
            case Cell.CELL_TYPE_STRING:  // 字符串类型
                return cell.getStringCellValue();

            case Cell.CELL_TYPE_NUMERIC:  // 数值类型（包括整数、小数、日期）
                // 判断是否为日期格式
                if (DateUtil.isCellDateFormatted(cell)) {
                    // 是日期，返回日期字符串
                    return cell.getDateCellValue().toString();
                } else {
                    // 是普通数字
                    double num = cell.getNumericCellValue();
                    // 如果是整数，去掉小数点
                    if (num == (long) num) {
                        return String.valueOf((long) num);
                    }
                    return String.valueOf(num);
                }

            case Cell.CELL_TYPE_BOOLEAN:  // 布尔类型
                return String.valueOf(cell.getBooleanCellValue());

            case Cell.CELL_TYPE_FORMULA:  // 公式类型
                //  拿到公式
                String cellFormula = cell.getCellFormula();
                // 计算公式 eval
                FormulaEvaluator FormulaEvaluator = new HSSFFormulaEvaluator((HSSFWorkbook) workbook);
                CellValue evaluate = FormulaEvaluator.evaluate(cell);

                // 返回计算后的值
                return evaluate.formatAsString();

            case Cell.CELL_TYPE_BLANK:  // 空类型
                return "";

            case Cell.CELL_TYPE_ERROR:  // 错误类型
                return "错误值: " + cell.getErrorCellValue();

            default:
                return "未知类型";
        }
    }
}

EasyExcal介绍

EasyExcel 是阿里巴巴开源的一个 excel 处理框架，以使用简单、节省内存著称。

EasyExcel 能大大减少占用内存的主要原因是在解析 Excel 时没有将文件数据一次性全部加载到内存中，而是从磁盘上一行行读取数据，逐个解析。

快速、简单避免 OOM 的 java 处理 Excel 工具

开源链接：https://github.com/alibaba/easyexcel

引入依赖：

 <!-- alibaba-easyexcel -->
<dependency>
     <groupId>com.alibaba</groupId>
     <artifactId>easyexcel</artifactId>
     <version>2.2.0-beta2</version>
</dependency>

写入操作

1、需要准备一个实体类。

/**
 * @author zhy
 * @version 1.0
 * @description: 基础数据类
 * @date 2026/3/21 17:25
 */
@Getter
@Setter
@EqualsAndHashCode
public class DemoData {
    @ExcelProperty("字符串标题")
    private String string;
    @ExcelProperty("日期标题")
    private Date date;
    @ExcelProperty("数字标题")
    private Double doubleData;
}

2、将实体类转变为list

    // 获取list
    public static List<DemoData> data(){
        List<DemoData> list = new ArrayList<DemoData>();
        for (int i = 0; i < 10; i++) {
            DemoData data = new DemoData();
            data.setString("字符串"+ i);
            data.setDate(new Date());data.setDoubleData(0.56);
            list.add(data);
        }
        return list;
    }

3、调用EasyExcal


/**
 * @author zhy
 * @version 1.0
 * @description: TODO
 * @date 2026/3/21 17:18
 */
public class EasyExcalWriteTest {
    static String PATH = "D:\\code\\Java\\POI-Project\\POI-Project\\";
    // 获取list
    public static List<DemoData> data(){
        List<DemoData> list = new ArrayList<DemoData>();
        for (int i = 0; i < 10; i++) {
            DemoData data = new DemoData();
            data.setString("字符串"+ i);
            data.setDate(new Date());data.setDoubleData(0.56);
            list.add(data);
        }
        return list;
    }
    // 根据List 写入excel
    public static void main(String[] args) {
        String fileName = PATH + "EasyTest.xlsx";
        // 这里需要指定写用哪个class去写，然后写到第一个sheet，名字为模板 然后文件流会自动关闭
        // write (fileName, 格式类)
        // sheet(表名)
        // doWrite(数据)
        EasyExcel.write(fileName, DemoData.class).sheet("EasyExcal").doWrite(data());
    }

}

效果展示：

读取操作

1、需要准备一个实体类。

/**
 * @author zhy
 * @version 1.0
 * @description: 基础数据类
 * @date 2026/3/21 17:25
 */
@Getter
@Setter
@EqualsAndHashCode
public class DemoData {
    @ExcelProperty("字符串标题")
    private String string;
    @ExcelProperty("日期标题")
    private Date date;
    @ExcelProperty("数字标题")
    private Double doubleData;
}

2、需要一个监听器，监听读取操作


/**
 * @author zhy
 * @version 1.0
 * @description: TODO
 * @date 2026/3/21 17:46
 */
public class DemoDataListener extends AnalysisEventListener<DemoData> {

    static final int BATCH_COUNT = 5;

    private List<DemoData> list = new ArrayList<>();

    // 读取数据会执行 invoke 方法
    // DemoData 类型
    // AnalysisContext 分析上文
    @Override
    public void invoke(DemoData demoData, AnalysisContext analysisContext) {
        System.out.println(JSON.toJSONString(demoData));
        list.add(demoData);
        // 达到BATCH_COUNT了，需要去存储一次数据库，防止数据几万条数据在内存，容易OOM
        if (list.size() >= BATCH_COUNT){
            //持久化逻辑
            // saveData();
        }
        // 存储完成清理List
        list.clear();
    }

    // 所有数据解析完成了都会来调用
    @Override
    public void doAfterAllAnalysed(AnalysisContext analysisContext) {
        System.out.println("所有数据解析完成！");
    }
}

3、调用EasyExcal

/**
 * @author zhy
 * @version 1.0
 * @description: TODO
 * @date 2026/3/21 17:18
 */
public class EasyExcalReadTest {
    static String PATH = "D:\\code\\Java\\POI-Project\\POI-Project\\";

    // 根据List 写入excel
    public static void main(String[] args) {
        String fileName = PATH + "EasyTest.xlsx";
        EasyExcel.read(fileName, DemoData.class,  new DemoDataListener()).sheet("EasyExcal").doRead();
    }

}

效果展示：

详细的操作请阅读操作文档

读取：https://www.yuque.com/easyexcel/doc/read

写入：https://www.yuque.com/easyexcel/doc/write

固定套路:
1、写入，固定类格式进行写入。
2、读取，根据监听器设置的规则进行读取!

AtomGit开源社区

AtomGit 是由开放原子开源基金会联合 CSDN 等生态伙伴共同推出的新一代开源与人工智能协作平台。平台坚持“开放、中立、公益”的理念，把代码托管、模型共享、数据集托管、智能体开发体验和算力服务整合在一起，为开发者提供从开发、训练到部署的一站式体验。

更多推荐

从零开发游戏需要学习的c#模块，第十一章（rpg小游戏入门，上篇，地图与移动）

AtomGit开源社区

通过 MCP 实现 AI Agent 目前有哪些最佳实践？

首先要介绍下什么是MCP，它的学名是“模型上下文协议”，你可以理解成它是连接AI大模型和外部工具的一个媒介，类似于电脑和互联网的关系，大模型原先只是封闭的大脑，有了MCP后它就连接了无数的信息、工具、数据，可以做更多的事情，比如Bright Data MCP能实现复杂网站的数据采集。总的来说，AI爬虫已经成为不可逆的趋势，完全不需要写代码处理网页，几乎零门槛，而且能很好的和一些智能体结合，做出不错