Java 高效实现 Excel 转 HTML：完整指南与代码示例

引言

在 Web 应用开发中，经常需要将 Excel 报表以网页形式在线展示，或嵌入系统内部预览。本文将详细介绍如何利用免费库 Free Spire.XLS for Java 将 Excel 文件转换为 HTML 格式，涵盖整个工作簿转换、指定工作表转换、图片嵌入等实用场景。代码简洁高效，无需安装 Microsoft Office，适合快速集成到各类 Java 项目中。

环境配置

1. 添加 Maven 依赖

在项目的pom.xml中配置以下仓库和依赖：

<repositories><repository><id>com.e-iceblue</id><name>e-iceblue</name><url>https://repo.e-iceblue.com/nexus/content/groups/public/</url></repository></repositories><dependency><groupId>e-iceblue</groupId><artifactId>spire.xls.free</artifactId><version>16.3.1</version></dependency>

如果不使用 Maven，也可手动下载 Jar 包并导入项目。

基础转换：整个 Excel 工作簿转 HTML

以下示例演示如何将 Excel 文件（支持.xls和.xlsx）完整转换为 HTML，并保留单元格样式、合并单元格、图片等基础格式。

importcom.spire.xls.FileFormat;importcom.spire.xls.Workbook;publicclassExcelToHtml{publicstaticvoidmain(String[]args){// 1. 加载 Excel 文档Workbookworkbook=newWorkbook();workbook.loadFromFile("sample.xlsx");// 2. 保存为 HTMLworkbook.saveToFile("output/whole_workbook.html",FileFormat.HTML);System.out.println("转换完成！");}}

核心步骤解析

• 创建 Workbook 对象：代表整个 Excel 文件。
• 加载 Excel 文档：调用loadFromFile(String fileName)方法，支持 .xls 和 .xlsx 格式。
• 保存为 HTML：调用saveToFile(String fileName, FileFormat.HTML)方法，生成包含所有工作表的 HTML 文件。

运行后，生成的 HTML 会保留 Excel 中的多个 Sheet，浏览器中可通过底部的标签页切换。

进阶转换：指定工作表并嵌入图片

实际开发中，往往只需要导出某个特定工作表（如“销售数据”），并希望表格中的图片直接嵌入 HTML（而非外部链接），以便于分享和离线查看。此时可使用HTMLOptions类进行精细化配置。

importcom.spire.xls.Workbook;importcom.spire.xls.Worksheet;importcom.spire.xls.core.spreadsheet.HTMLOptions;publicclassSheetToHtmlWithImage{publicstaticvoidmain(String[]args){// 1. 加载 ExcelWorkbookworkbook=newWorkbook();workbook.loadFromFile("product.xlsx");// 2. 获取第一个工作表Worksheetsheet=workbook.getWorksheets().get(0);// 3. 设置 HTML 选项：图片嵌入HTMLOptionsoptions=newHTMLOptions();options.setImageEmbedded(true);// true 表示将图片转为 base64 嵌入 HTML// 4. 保存指定工作表为 HTMLsheet.saveToHtml("output/single_sheet.html",options);System.out.println("单个工作表转换成功，图片已嵌入。");}}

通过setImageEmbedded(true)，图片数据将以 Base64 格式直接写入 HTML，最终只需一个.html文件即可完整显示所有内容，无需额外图片文件夹。

转换为多个 HTML 文件

如果需要将每个工作表分别导出为独立的 HTML 文件，可以遍历工作表集合：

importcom.spire.xls.Workbook;importcom.spire.xls.Worksheet;publicclassExportAllSheetsSeparately{publicstaticvoidmain(String[]args){Workbookworkbook=newWorkbook();workbook.loadFromFile("quarterly_report.xlsx");for(inti=0;i<workbook.getWorksheets().size();i++){Worksheetsheet=workbook.getWorksheets().get(i);StringfileName="output/sheet_"+sheet.getName()+".html";sheet.saveToHtml(fileName);System.out.println("已导出: "+fileName);}}}

常见问题与解决方案

1. 中文字体显示异常怎么办？

生成的 HTML 依赖浏览器解析字体。如果目标环境（如 Linux 服务器）缺少中文字体，建议安装常用字体（如微软雅黑、宋体），或在 CSS 中指定通用字体族（如sans-serif）。

2. 图片未能正常显示？

请确认：

• Excel 中的图片是否为嵌入对象（而非链接图片）。
• 代码中已调用options.setImageEmbedded(true)。
• 若仍不显示，检查 Excel 文件是否包含图表或复杂对象（免费版可能不支持部分高级特性）。

3. 样式错乱或丢失

可考虑：

• 简化 Excel 样式，尽量使用基础格式。
• 测试不同浏览器（Chrome、Firefox、Edge）的渲染效果。

总结

本文通过两个典型示例，展示了如何利用 Java 将 Excel 文件转换为 HTML。整个过程无需 Office 环境，代码简洁且易于集成。开发者可根据实际需求调整选项（如是否嵌入图片），以达到理想的输出效果。

温馨提示：免费版对工作表数量有一定限制，使用时注意限制。