在 Java 中将 XLSX 转换为 HTML – 使用 GroupDocs.Viewer 渲染电子表格打印区域

如果您需要 convert XLSX to HTML 并且只显示工作簿中重要的部分，渲染已定义的打印区域是最佳方案。本教程将手把手教您构建一个 Java 预览解决方案，提取 Excel 文件中的打印区域，并使用 GroupDocs.Viewer for Java 输出干净、独立的 HTML 页面。您将了解为何此方法能够加快加载速度、降低带宽消耗，并保持 UI 整洁——非常适合门户、仪表盘以及任何基于 Web 的文档查看器。

使用 GroupDocs.Viewer for Java 渲染电子表格打印区域

快速答案

“convert XLSX to HTML” 是什么意思？ 它指的是以编程方式将 Excel 工作簿转换为可在浏览器中直接显示的 HTML 页面。
为什么只渲染 Excel 打印区域？ 这样可以只保留最相关的数据，缩短渲染时间并降低带宽占用。
试用是否需要许可证？ 提供免费试用或临时许可证；生产环境需要购买正式许可证。
支持哪个 Java 版本？ 支持 Java 8 或更高版本（推荐 Java 11）。
可以将预览嵌入网页吗？ 可以——使用 embedded‑resources 选项即可生成独立的 HTML 页面。

什么是“convert XLSX to HTML”？

将 XLSX 文件转换为 HTML 意味着把电子表格的可视布局导出为浏览器可直接渲染的 HTML 标记，而无需依赖 Excel。这是 how to preview spreadsheet 内容在 Web 应用中展示的核心技术，能够让用户即时、安全地查看数据。

为什么只渲染 Excel 打印区域？

性能： 更小的 HTML 负载加载更快。
清晰度： 只显示标记为打印的部分，避免页面杂乱。
安全性： 未标记的工作表在预览中保持隐藏。

前置条件

GroupDocs.Viewer for Java v25.2 或更高版本。
开发机器上已安装 Maven。
JDK 8 或更高（推荐 Java 11）。
任意 IDE（IntelliJ IDEA、Eclipse 或 VS Code）。

设置 GroupDocs.Viewer for Java

在 pom.xml 中添加 GroupDocs 仓库和依赖：

<repositories>
    <repository>
        <id>repository.groupdocs.com</id>
        <name>GroupDocs Repository</name>
        <url>https://releases.groupdocs.com/viewer/java/</url>
    </repository>
</repositories>
<dependencies>
    <dependency>
        <groupId>com.groupdocs</groupId>
        <artifactId>groupdocs-viewer</artifactId>
        <version>25.2</version>
    </dependency>
</dependencies>

获取许可证

先使用 free trial 或申请 temporary license 进行评估。准备投入生产时，请购买正式许可证以解锁全部功能并移除试用限制。

基本初始化

下面的代码展示了使用 GroupDocs.Viewer 打开电子表格的最小示例：

import com.groupdocs.viewer.Viewer;

// Initialize Viewer object with the path to your spreadsheet
try (Viewer viewer = new Viewer("path/to/your/spreadsheet.xlsx")) {
    // Further configurations will be discussed in upcoming sections.
}

如何使用 GroupDocs.Viewer 将 XLSX 转换为 HTML

下面提供了一个逐步演示，仅 render excel print area，生成独立的 HTML 文件。

步骤 1：定义输出目录和文件路径格式

首先告诉 Viewer 将生成的 HTML 页面写入何处。

import java.nio.file.Path;
import java.nio.file.Paths;

// Set the output directory path
Path outputDirectory = Paths.get("YOUR_OUTPUT_DIRECTORY");

// Define a file path format for the rendered pages
Path pageFilePathFormat = outputDirectory.resolve("page_{0}.html");

解释： outputDirectory 是存放所有预览文件的文件夹。pageFilePathFormat 使用占位符（{0}），Viewer 会在渲染时替换为实际的页码。

步骤 2：为打印区域渲染配置 HTML 视图选项

配置 Viewer 将资源（CSS、图片）内嵌，并聚焦于已定义的打印区域。

import com.groupdocs.viewer.options.HtmlViewOptions;
import com.groupdocs.viewer.options.SpreadsheetOptions;

// Configure HTML view options with embedded resources and print area rendering
HtmlViewOptions viewOptions = HtmlViewOptions.forEmbeddedResources(pageFilePathFormat);
viewOptions.setSpreadsheetOptions(SpreadsheetOptions.forRenderingPrintArea());

解释： HtmlViewOptions.forEmbeddedResources 会为每页生成一个包含所有 CSS/JS 的单一 HTML 文件，简化部署。forRenderingPrintArea() 指示引擎仅 render excel print area。

步骤 3：加载电子表格并渲染

最后，指向工作簿并调用渲染过程。

// Replace with your actual document path
Path documentPath = Paths.get("YOUR_DOCUMENT_DIRECTORY/SAMPLE_XLSX_WITH_PRINT_AREAS.xlsx");

try (Viewer viewer = new Viewer(documentPath.toString())) {
    // Render to HTML using the configured view options
    viewer.view(viewOptions);
}

解释： view() 方法按照我们设置的选项处理工作簿，输出仅显示打印区域的 HTML 文件。

常见问题及解决方案

文件路径错误： 请确认路径是绝对路径或相对于项目工作目录的正确相对路径。
权限问题： 确保 Java 进程对源文件有读取权限，对输出文件夹有写入权限。
缺少打印区域： 检查电子表格是否已在 Excel 中设置了打印区域（页面布局 → 打印区域）。

实际应用

文档管理系统： 为终端用户提供仅包含报告关键部分的简洁预览，避免加载整个工作簿。
金融仪表盘： 自动生成标记为打印区域的关键财务表格的 HTML 快照。
学习平台： 为学生提供作业数据的聚焦视图。
CRM 门户： 突出显示客户指标，同时隐藏内部工作表。
数据科学笔记本： 在文档中嵌入简洁的电子表格预览。

性能提示

内存调优： 对于超大工作簿，可增大 JVM 堆内存（-Xmx2g 或更高）。
懒加载： 若只需前几页，可在渲染到所需页数后停止。
并行处理： 使用独立的 Viewer 实例（每个线程一个）并行渲染多个工作簿。

如何在不使用打印区域的情况下预览电子表格

如果以后想显示完整工作簿，只需去掉 SpreadsheetOptions.forRenderingPrintArea() 调用，改用默认的 SpreadsheetOptions 即可，这样即可获得完整的 convert spreadsheet to html 体验。

结论

您已经学会了在 Java 中 convert XLSX to HTML，并仅渲染电子表格中定义的打印区域。这一技巧能够让预览更快、更简洁、更安全——非常适合现代 Web 与企业应用。

后续步骤

使用 PdfViewOptions 或 PngViewOptions 试验其他视图格式（PDF、PNG）。
将预览生成与身份验证结合，以保护敏感数据。
探索完整的 SpreadsheetOptions API，了解自定义页面尺寸、网格线等更多功能。

常见问答

问：只渲染 Excel 打印区域的主要好处是什么？
答：它可以减少页面杂乱并加快渲染速度，提供聚焦的预览，突出最重要的数据。

问：我可以同时渲染不可打印的工作表吗？
答：可以——去掉 SpreadsheetOptions.forRenderingPrintArea() 并使用默认选项，即可渲染整个工作簿。

问：GroupDocs.Viewer 是否支持其他电子表格格式？
答：支持 XLS、XLSX、CSV、ODS 等多种格式。完整列表请参阅官方文档。

问：如何提升对超大文件的渲染速度？
答：增大 JVM 堆内存、仅渲染所需页数，并考虑使用多线程并行处理。

问：我的打印区域未显示，应该检查什么？
答：确保在源文件中已定义打印区域（Excel → 页面布局 → 打印区域），并使用最新版本的 GroupDocs.Viewer。

资源

文档： GroupDocs.Viewer Java Documentation
API 参考： GroupDocs API Reference
下载： Get GroupDocs.Viewer for Java
购买： Buy a License
免费试用： Start with a Free Trial
临时许可证： Request Here
支持： GroupDocs Forum

最后更新： 2026-03-19
测试环境： GroupDocs.Viewer for Java 25.2
作者： GroupDocs