首页 / 新闻资讯 / 使用 Apache POI 实现 Excel 到 HTML 的转换：完整指南与代码示例

使用 Apache POI 实现 Excel 到 HTML 的转换：完整指南与代码示例

发布时间：2026-06-12 作者：雷静 阅读量：19

引言

在 Web 开发和数据展示中，经常需要将 Excel 文件内容以网页形式呈现。Apache POI 作为 Java 领域处理 Microsoft Office 文档的开源库，提供了强大的 API 来读写 Excel 文件。通过 POI，我们可以轻松提取 Excel 数据并将其转换为 HTML 格式，实现数据在浏览器中的动态展示。

环境准备

首先需要在项目中引入 Apache POI 依赖。以 Maven 为例，在 pom.xml 中添加以下配置：

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

确保已安装 JDK 8 或更高版本，并正确配置开发环境。

核心实现步骤

转换过程主要分为三个阶段：读取 Excel 文件、解析单元格数据、生成 HTML 输出。

1. 读取 Excel 文件

使用 HSSFWorkbook 处理 .xls 文件，使用 XSSFWorkbook 处理 .xlsx 文件。以下代码展示如何根据文件后缀自动选择工作簿：

public static Workbook getWorkbook(String filePath) throws IOException {
    File file = new File(filePath);
    String fileName = file.getName().toLowerCase();
    if (fileName.endsWith(".xls")) {
        return new HSSFWorkbook(new FileInputStream(file));
    } else if (fileName.endsWith(".xlsx")) {
        return new XSSFWorkbook(new FileInputStream(file));
    } else {
        throw new IllegalArgumentException("不支持的文件格式");
    }
}

2. 遍历单元格并构建 HTML

通过遍历工作表的行和单元格，提取数据并处理合并区域。使用 StringBuilder 动态构建 HTML 标签：

StringBuilder html = new StringBuilder();
html.append("<table border='1'>");
for (Row row : sheet) {
    html.append("<tr>");
    for (int i = 0; i < row.getLastCellNum(); i++) {
        Cell cell = row.getCell(i);
        if (cell == null) {
            html.append("<td></td>");
        } else {
            // 处理单元格值和样式
            String value = getCellValue(cell);
            html.append("<td>").append(value).append("</td>");
        }
    }
    html.append("</tr>");
}
html.append("</table>");

3. 处理样式与合并区域

通过 CellType 判断单元格类型，并提取字体颜色、背景色等样式信息。对于合并区域，需要使用 CellRangeAddress 进行映射处理，避免重复输出数据。

完整代码示例

以下是一个可直接运行的工具类，实现了 Excel 到 HTML 的完整转换：

public class ExcelToHtmlConverter {
    // 核心转换方法
    public static String convert(String filePath) throws IOException {
        Workbook workbook = getWorkbook(filePath);
        StringBuilder htmlBuilder = new StringBuilder();
        // 遍历所有工作表
        for (int i = 0; i < workbook.getNumberOfSheets(); i++) {
            Sheet sheet = workbook.getSheetAt(i);
            htmlBuilder.append("<h3>" + sheet.getSheetName() + "</h3>");
            // 构建表格逻辑（同上述步骤）
        }
        workbook.close();
        return htmlBuilder.toString();
    }
}

常见问题与优化

  • 内存溢出处理：对于大文件，使用流式读取（如 SXSSFWorkbook）或分块处理。
  • 样式保留：通过 CellStyle 提取 CSS 样式，生成内联样式或样式表。
  • 性能优化：避免在循环中重复创建对象，使用缓存存储已解析的样式。
  • 特殊字符转义：对 HTML 实体字符进行编码，防止 XSS 攻击。

应用场景

该技术可用于报表导出、数据可视化、在线文档预览等场景。结合 Web 框架（如 Spring Boot），可以构建完整的 Excel 数据展示服务。

总结

使用 Apache POI 实现 Excel 转 HTML 是一种高效且灵活的数据转换方案。通过合理设计代码结构，不仅可以保留原始数据结构，还能扩展样式支持，满足多种业务需求。建议在实际开发中根据文件大小和复杂度选择适当的优化策略，以确保系统稳定性和性能。

相关文章