每个工作表一页：在 Java 中自动将电子表格转换为 PDF

如果您厌倦了手动将电子表格转换为 PDF，您来对地方了。在本教程中，您将看到 GroupDocs.Conversion for Java 如何 自动化电子表格转换，并提供细粒度的控制——例如仅加载所需的行并生成 每个工作表一页 的 PDF 输出。完成后，您将了解如何：

  • 在加载工作簿时指定单元格范围
  • 配置转换器，使每个工作表成为单页 PDF
  • 使用最新的 GroupDocs.Conversion 库设置您的 Java 项目

在深入代码之前，让我们先准备好环境。

快速答案

  • “每个工作表一页”是什么意思？ 源 Excel 文件中的每个工作表在生成的 PDF 中呈现为单页。
  • 哪个库负责转换？ Java 版 GroupDocs.Conversion（版本 25.2）。
  • 我需要许可证吗？ 免费试用可用于评估；在生产环境中需要临时或购买的许可证。
  • 我可以高效地转换大型电子表格吗？ 可以——仅加载所需范围即可降低内存使用并加快处理速度。
  • 需要哪个 Java 版本？ JDK 8 或更高版本。

什么是“每个工作表一页”？

每个工作表一页 意味着转换器将每个工作表的全部内容压缩到单个 PDF 页面上，无论该工作表包含多少打印区域。此方式保证页面数量可预测，且非常适合报告或幻灯片式 PDF，其中每个工作表对应一个可视页面。

为什么使用 GroupDocs.Conversion for Java？

GroupDocs.Conversion for Java 是一个 强大、高性能 的转换引擎。它支持 30 多种电子表格格式（XLS、XLSX、CSV、ODS 等），并且能够在不将整个文档加载到内存中的情况下处理高达 500 MB 的文件，这得益于其流式架构。API 简洁：少量方法调用即可生成可直接投入生产的 PDF，保留表格、图表和单元格格式。

前置条件

  • Java Development Kit (JDK) 8+ 已安装
  • Maven 用于依赖管理
  • 如 IntelliJ IDEA 或 Eclipse 的 IDE
  • 基本的 Java 知识并熟悉 Maven 项目结构

为 Java 设置 GroupDocs.Conversion

Maven 配置

在您的 pom.xml 中添加 GroupDocs 仓库和转换依赖：

pom.xml 必须包含 <groupId>com.groupdocs</groupId> 仓库条目以及 <artifactId>groupdocs-conversion</artifactId> 依赖。保存文件后，运行 mvn clean install 下载库。

获取许可证的步骤

  • 免费试用 – 下载试用版以测试功能。
  • 临时许可证 – 在开发期间请求临时许可证以获得完整功能访问。
  • 购买 – 从 GroupDocs 网站 购买许可证。

添加依赖后，您可以开始使用 API：

Converter 是负责文档转换的主类。导入 com.groupdocs.conversion 包，创建 Converter 实例，并调用相应的转换方法。

如何使用特定范围加载电子表格？

加载特定范围会指示引擎忽略定义区域之外的行和列，从而加快转换速度并降低内存消耗。
setConvertRange 配置转换仅包含特定单元格范围。setConvertRange 方法接受类似 "A10:C30" 的范围字符串，并将转换限制在这些单元格内。当处理 大型 Excel 文件 且仅有部分数据与 PDF 输出相关时，这尤其有用。

如何将电子表格转换为每个工作表一页的 PDF？

setOnePagePerSheet 强制每个工作表在单个 PDF 页面上渲染。 在转换设置对象上设置 setOnePagePerSheet(true) 选项。此标志强制转换器将每个工作表渲染为单页 PDF，无论其原始打印布局如何。转换运行时，引擎会遍历工作簿中的每个工作表，应用范围过滤（如果有），并将每个工作表写入最终 PDF 文档的单独页面。

实际应用

场景功能如何帮助
财务报告仅加载包含季度数字的行，为每个部门生成整洁的每个工作表一页 PDF。
学术出版转换研究数据表，聚焦相关范围，并确保每个工作表单独打印在一页上，便于引用。
商务演示创建可直接用于演示的 PDF，每张幻灯片对应一个工作表，得益于每个工作表一页的设置。

性能考虑

  • 缩小转换范围 – 使用 setConvertRange 限制行/列。
  • 及时释放资源 – 关闭流并在转换后让 Converter 超出作用域。
  • 并行处理 – 对于批量任务，在独立线程上运行转换以保持 UI 响应。

常见问题

问：GroupDocs.Conversion 所需的最低 Java 版本是什么？
答：建议使用 JDK 8 或更高版本，以确保与库的完整兼容性。

问：我可以一次转换多种电子表格格式吗？
答：可以，GroupDocs.Conversion 在一次转换调用中支持 Excel、CSV、ODS 等多种格式。

问：如何获取临时许可证以获得完整功能？
答：可通过 GroupDocs 网站 申请。

问：如果我的电子表格太大，无法在内存中转换怎么办？
答：使用 setConvertRange 仅加载所需范围，并考虑在转换期间将文件流式写入磁盘。

问：我可以将 GroupDocs.Conversion 与云存储服务集成吗？
答：可以，您可以使用标准的 Java I/O 流读取和写入 AWS S3、Azure Blob Storage、Google Cloud Storage 等。

资源

最后更新： 2026-08-14
测试版本： GroupDocs.Conversion 25.2 for Java
作者： GroupDocs

<repositories>
   <repository>
      <id>repository.groupdocs.com</id>
      <name>GroupDocs Repository</name>
      <url>https://releases.groupdocs.com/conversion/java/</url>
   </repository>
</repositories>

<dependencies>
   <dependency>
      <groupId>com.groupdocs</groupId>
      <artifactId>groupdocs-conversion</artifactId>
      <version>25.2</version>
   </dependency>
</dependencies>

import com.groupdocs.conversion.Converter;
// Basic initialization code here...

import com.groupdocs.conversion.options.load.SpreadsheetLoadOptions;

public class FeatureLoadSpreadsheetWithRange {
    public static void run() {
        // Create load options for specifying a range of cells
        SpreadsheetLoadOptions loadOptions = new SpreadsheetLoadOptions();
        
        // Specify the cell range (e.g., "10:30" means rows 10 to 30)
        loadOptions.setConvertRange("10:30");
    }
}

import com.groupdocs.conversion.Converter;
import com.groupdocs.conversion.options.convert.PdfConvertOptions;

public class FeatureConvertToPdfWithOnePagePerSheet {
    public static void run() {
        // Initialize load options with one-page-per-sheet setting
        SpreadsheetLoadOptions loadOptions = new SpreadsheetLoadOptions();
        loadOptions.setOnePagePerSheet(true);
        
        // Initialize the Converter object with your document path and load options
        Converter converter = new Converter("YOUR_DOCUMENT_DIRECTORY/sample.xlsx", () -> loadOptions);
        
        // Configure PDF conversion to produce one page per sheet
        PdfConvertOptions pdfOptions = new PdfConvertOptions();
        
        // Execute the conversion process
        converter.convert("YOUR_OUTPUT_DIRECTORY/ConvertedSpreadsheet.pdf", pdfOptions);
    }
}

相关教程