如何在 Java 中使用 GroupDocs.Viewer 从 Excel 生成 HTML

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

快速答案

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

什么是 “generate HTML from Excel”？

Generate HTML from Excel 指将 XLSX 工作簿的可视布局转换为标准 HTML 标记，浏览器能够原生渲染。这种技术让您在 Web 应用中即时预览电子表格数据，而无需在客户端安装 Microsoft Office。

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

仅渲染打印区域可以生成更小的 HTML 负载，典型报表的加载速度提升可达 60 %。同时，它还能隐藏可能包含敏感公式的内部工作表，提高安全性。通过聚焦用户自定义的打印区域，您可以提供更简洁、更符合作者意图的视图。

前置条件

• GroupDocs.Viewer for Java v25.2 或更高（支持 70 多种文档格式，并可在不将整个文件加载到内存的情况下处理最多 10,000 行的电子表格）。
• 在开发机器上安装 Maven。
• JDK 8 或更高（推荐 Java 11）。
• 任意 IDE（IntelliJ IDEA、Eclipse 或 VS Code）。

设置 GroupDocs.Viewer for Java

将 GroupDocs 仓库和依赖添加到您的 pom.xml 中：

<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>

许可证获取

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

基本初始化

Viewer 是加载文档并驱动渲染管道的核心类。下面是使用 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

本节展示如何利用 GroupDocs.Viewer 将 XLSX 工作簿转换为仅显示已定义打印区域的独立 HTML 文件。通过配置视图选项并调用查看器，您可以生成轻量级预览，适合嵌入网页或门户。

下面提供一步步的演示，仅 渲染 Excel 打印区域，生成独立的 HTML 文件。

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

首先，告诉查看器将生成的 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}），查看器会用页码替换该占位符。

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

HtmlViewOptions 控制 HTML 的生成方式。forEmbeddedResources 会为每页创建一个包含所有 CSS/JS 内联的单一 HTML 文件，简化部署。forRenderingPrintArea() 告诉引擎仅 渲染 Excel 打印区域。

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() 告诉引擎仅 渲染 Excel 打印区域。

步骤 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 中的 页面布局 → 打印区域）。

实际应用场景

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

性能优化技巧

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

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

SpreadsheetOptions 用于配置电子表格渲染行为，包括是否限制输出到已定义的打印区域。如果您之后想显示整个工作簿，只需省略 SpreadsheetOptions.forRenderingPrintArea() 调用，使用默认的 SpreadsheetOptions 即可。这将渲染每个工作表和单元格，提供完整的 convert XLSX to HTML 预览，包含原文件中的所有数据、公式和格式。

结论

您现在已经掌握了如何在 Java 中使用 GroupDocs.Viewer generate HTML from Excel，并仅渲染电子表格的定义打印区域。此技术让预览更快、更清晰、更安全——非常适合现代 Web 与企业应用。

后续步骤

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

常见问答

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

Q: 我可以同时渲染不可打印的工作表吗？
A: 可以——省略 SpreadsheetOptions.forRenderingPrintArea() 并使用默认选项即可渲染整个工作簿。

Q: GroupDocs.Viewer 支持其他电子表格格式吗？
A: 支持 XLS、XLSX、CSV、ODS 等多种格式。完整列表请参阅官方文档。

Q: 如何提升对超大文件的渲染速度？
A: 增大 JVM 堆内存，仅渲染所需页面，并考虑多线程处理。

Q: 我的打印区域未显示——该检查什么？
A: 确认源文件已定义打印区域（Excel → 页面布局 → 打印区域），并使用最新版本的 GroupDocs.Viewer。

资源

• 文档： GroupDocs.Viewer Java 文档
• API 参考： GroupDocs API 参考
• 下载： 获取 GroupDocs.Viewer for Java
• 购买： 购买许可证
• 免费试用： 开始免费试用
• 临时许可证： 在此申请
• 支持： GroupDocs 论坛

最后更新： 2026-09-15
已测试于： GroupDocs.Viewer for Java 25.2
作者： GroupDocs

相关教程

• 使用 GroupDocs.Viewer Java 将 Excel 转换为 HTML、JPG、PNG 和 PDF
• excel to html java：使用 GroupDocs.Viewer 跳过渲染空行
• 使用 GroupDocs.Viewer 将 Excel 转换为 HTML 并渲染隐藏行列（Java）