当前位置：首页 > news >正文

Hutool - POI：让 Excel 与 Word 操作变得轻而易举

news 来源：原创 2025/6/23 5:14:02

各位开发者们，在日常的 Java 开发工作里，处理 Excel 和 Word 文件是相当常见的需求。无论是从 Excel 里读取数据进行分析，还是将数据写入 Excel 生成报表，亦或是对 Word 文档进行内容编辑，传统的 Apache POI 库虽然功能强大，但使用起来往往比较复杂，代码量也不少。不过，有了 Hutool - POI 这个得力助手，一切都变得轻松起来了。它对 Apache POI 进行了封装，提供了简洁易用的 API，让我们可以更高效地操作 Excel 和 Word 文件。

一、Excel 操作：数据读写如此简单

1. 从 Excel 读取数据

假设我们有一个 Excel 文件，里面存储着员工信息，现在要把这些信息读取出来。

import cn.hutool.poi.excel.ExcelReader;
import cn.hutool.poi.excel.ExcelUtil;
import java.util.List;
import java.util.Map;

public class ExcelReadExample {
    public static void main(String[] args) {
        // 创建 Excel 读取器
        ExcelReader reader = ExcelUtil.getReader("employees.xlsx");
        // 读取数据，每行数据以 Map 形式存储
        List<Map<String, Object>> dataList = reader.readAll();
        for (Map<String, Object> row : dataList) {
            System.out.println("员工信息: " + row);
        }
        // 关闭读取器
        reader.close();
    }
}

在这段代码中，我们使用 ExcelUtil.getReader 方法创建了一个 Excel 读取器，指定要读取的 Excel 文件。然后调用 readAll 方法，将 Excel 中的所有数据读取出来，每行数据都以 Map 的形式存储，键是列名，值是单元格的值。最后遍历这个数据列表，输出每一行的员工信息。别忘了，使用完读取器后要调用 close 方法关闭它，释放资源。

2. 将数据写入 Excel

现在我们有一些员工数据，要把它们写入到一个新的 Excel 文件中。

import cn.hutool.poi.excel.ExcelWriter;
import cn.hutool.poi.excel.ExcelUtil;
import java.util.ArrayList;
import java.util.HashMap;
import java.util.List;
import java.util.Map;

public class ExcelWriteExample {
    public static void main(String[] args) {
        // 准备数据
        List<Map<String, Object>> dataList = new ArrayList<>();
        Map<String, Object> row1 = new HashMap<>();
        row1.put("姓名", "张三");
        row1.put("年龄", 25);
        dataList.add(row1);

        Map<String, Object> row2 = new HashMap<>();
        row2.put("姓名", "李四");
        row2.put("年龄", 30);
        dataList.add(row2);

        // 创建 Excel 写入器
        ExcelWriter writer = ExcelUtil.getWriter("new_employees.xlsx");
        // 写入数据
        writer.write(dataList, true);
        // 关闭写入器
        writer.close();
        System.out.println("数据已成功写入 Excel 文件");
    }
}

这里，我们先创建了一个包含员工信息的 List<Map<String, Object>> 数据列表。然后使用 ExcelUtil.getWriter 方法创建一个 Excel 写入器，指定要写入的文件名称。调用 write 方法将数据写入到 Excel 中，第二个参数 true 表示是否写入表头。最后关闭写入器，数据就成功写入到新的 Excel 文件里了。

二、Word 操作：内容编辑得心应手

1. 创建并填充 Word 文档

我们来创建一个简单的 Word 文档，并且往里面添加一些文本内容。

import cn.hutool.poi.word.WordUtil;
import java.io.File;

public class WordCreateExample {
    public static void main(String[] args) {
        String content = "这是一个使用 Hutool - POI 创建的 Word 文档示例。";
        // 创建 Word 文档并写入内容
        WordUtil.writeWord(content, new File("example.docx"));
        System.out.println("Word 文档创建成功");
    }
}

在这个例子中，我们定义了一段文本内容，然后使用 WordUtil.writeWord 方法将这段内容写入到一个新的 Word 文档中，指定文档的存储路径和文件名。运行代码后，一个包含指定内容的 Word 文档就创建好了。

2. 读取 Word 文档内容

如果我们有一个已有的 Word 文档，想要读取其中的内容，也很容易实现。

import cn.hutool.poi.word.WordUtil;
import java.io.File;

public class WordReadExample {
    public static void main(String[] args) {
        // 读取 Word 文档内容
        String content = WordUtil.readWord(new File("example.docx"));
        System.out.println("Word 文档内容: " + content);
    }
}

使用 WordUtil.readWord 方法，传入要读取的 Word 文件对象，就能把文档中的内容读取出来并以字符串的形式返回，方便我们进一步处理。

三、注意事项

在使用 Hutool - POI 进行 Excel 和 Word 操作时，也有一些需要留意的地方。对于 Excel 操作，要注意数据类型的匹配，确保写入的数据类型和 Excel 单元格的类型兼容。同时，处理大量数据时，要考虑性能问题，可以采用分批读取和写入的方式。对于 Word 操作，不同版本的 Word 文档可能会有一些格式差异，在处理时要进行充分的测试。另外，操作文件时要确保文件的读写权限，避免出现权限不足的错误。

总之，Hutool - POI 为我们提供了一种简单、高效的方式来操作 Excel 和 Word 文件。无论是新手开发者还是有经验的老程序员，都能借助它快速实现文件处理的需求，提升开发效率，让我们把更多的精力放在业务逻辑上。大家不妨在自己的项目中试试，相信它会给你带来不错的体验！