使用 GroupDocs.Conversion for Java 將試算表轉換為 PDF：完整指南

將 Excel 工作簿轉換為乾淨、可在任何平台閱讀的 PDF 是開發人員常見的需求，因為他們希望在分享資料時不必擔心格式問題。在本教學中，您將學習如何 將試算表轉換為 PDF，同時確保 每個工作表僅一頁、隱藏註解，並處理 java convert xlsx pdf 任務的典型挑戰。

快速解答

什麼是「每個工作表僅一頁」的意思？
每個工作表都會渲染為一頁 PDF，無論其原始大小如何。
哪個函式庫負責轉換？
GroupDocs.Conversion for Java.
註解可以自動隱藏嗎？
可以，使用 SpreadsheetLoadOptions.setHideComments(true)。
我需要授權嗎？
免費試用可用於評估；正式環境需購買完整授權。
這適用於大量批次處理嗎？
可以，將檔案分批處理並監控記憶體使用情況。

什麼是「每個工作表僅一頁」的轉換？

當您將 Excel 工作簿轉換為 PDF 時，預設行為可能會將大型工作表分割成多頁。啟用 每個工作表僅一頁 選項會強制將每個工作表壓縮至單一 PDF 頁面，產生簡潔、可直接用於簡報的文件。

為什麼使用 GroupDocs.Conversion for Java？

GroupDocs.Conversion 提供高階 API，抽象化檔案格式處理的底層細節。它支援如隱藏註解、頁面版面控制等進階選項，且可無縫整合至基於 Maven 的專案——非常適合 excel pdf conversion java 場景。

前置條件

GroupDocs.Conversion for Java（版本 25.2 或更新）
Java Development Kit (JDK) 已安裝於您的機器
如 IntelliJ IDEA 或 Eclipse 等 IDE
基本的 Java 知識與 Maven 使用經驗

必要的函式庫與相依性

GroupDocs.Conversion for Java：版本 25.2 或更新。
Java Development Kit (JDK)：確保系統已安裝 JDK。

環境設定

使用如 IntelliJ IDEA 或 Eclipse 等整合開發環境 (IDE)。

知識前提

基本的 Java 程式設計概念。
熟悉 Maven 以進行相依性管理。

設定 GroupDocs.Conversion for Java

我們將使用 Maven 管理此函式庫。將儲存庫與相依性加入您的 pom.xml：

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

取得授權

若要完整使用 GroupDocs.Conversion，請取得免費試用或永久授權。正式環境使用時，請從 GroupDocs 授權購買頁面購買授權。

基本初始化

import com.groupdocs.conversion.Converter;

public class Main {
    public static void main(String[] args) {
        // Basic initialization of the Converter class
        String inputFilePath = "path/to/your/document.xlsx";
        Converter converter = new Converter(inputFilePath);
        
        System.out.println("Converter initialized successfully!");
    }
}

實作指南

使用進階選項載入試算表

概觀

使用自訂選項載入試算表，可在轉換前隱藏註解並強制執行 每個工作表僅一頁 規則。

步驟 1：設定載入選項

Create an instance of SpreadsheetLoadOptions and configure it:

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

public class LoadSpreadsheetWithOptions {
    public static void main(String[] args) {
        // Create an instance of SpreadsheetLoadOptions
        SpreadsheetLoadOptions loadOptions = new SpreadsheetLoadOptions();
        
        // Set options to hide comments and set one page per sheet
        loadOptions.setHideComments(true);
        loadOptions.setOnePagePerSheet(true);

        System.out.println("Loading options configured!");
    }
}

setHideComments(true)：從 PDF 輸出中移除所有儲存格註解。
setOnePagePerSheet(true)：確保 每個工作表僅一頁 版面配置。

將試算表轉換為 PDF

概觀

現在載入選項已設定完畢，我們將把工作簿轉換為 PDF 檔案。

步驟 2：定義檔案路徑

Specify where the source Excel file lives and where the resulting PDF should be saved:

String inputFilePath = "YOUR_DOCUMENT_DIRECTORY/SAMPLE_XLSX";
String outputFilePath = "YOUR_OUTPUT_DIRECTORY/ConvertSpreadsheetAndHideComments.pdf";

步驟 3：使用載入選項初始化 Converter

Pass the loading options via a lambda when constructing the Converter:

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

public class ConvertSpreadsheetToPdf {
    public static void main(String[] args) {
        SpreadsheetLoadOptions loadOptions = new SpreadsheetLoadOptions();
        loadOptions.setHideComments(true);
        loadOptions.setOnePagePerSheet(true);

        // Create an instance of Converter with loading options
        Converter converter = new Converter(inputFilePath, () -> loadOptions);

        System.out.println("Converter ready for conversion!");
    }
}

步驟 4：轉換為 PDF

Apply the conversion options and execute the process:

PdfConvertOptions options = new PdfConvertOptions();
converter.convert(outputFilePath, options);
System.out.println("Conversion completed successfully!");

PdfConvertOptions 讓您調整 PDF 輸出（例如中繼資料、壓縮）。預設設定對大多數 convert spreadsheet pdf java 使用情境皆相當適用。

常見問題與解決方案

檔案路徑問題 – 確認輸入與輸出目錄皆存在且具讀寫權限。
相依性錯誤 – 確保 Maven 儲存庫 URL 正確，且版本與 pom.xml 中聲明的相符。
記憶體消耗 – 對於大型工作簿，建議逐張工作表處理或增加 JVM 堆積大小。

實務應用

財務報告 – 產生單頁 PDF 的資產負債表，以便快速讓利害關係人審閱。
資料隱私 – 在與外部合作夥伴分享報告前隱藏內部註解。
簡報準備 – 將多工作表的 Excel 模型轉換為簡潔的 PDF，供投影片使用。

效能考量

記憶體管理 – 監控堆積使用情況；及時釋放 Converter 實例。
批次處理 – 轉換大量檔案時，將其分成可管理的批次迴圈處理，以避免記憶體不足錯誤。

結論

您現在已掌握如何使用 GroupDocs.Conversion 進行 java convert xlsx pdf 檔案的轉換，同時強制 每個工作表僅一頁 版面並隱藏註解。可嘗試使用額外的 PdfConvertOptions 以符合您的精確需求，並將此工作流程整合至更大型的自動化管線中。

後續步驟

探索其他轉換格式（例如 DOCX、PPTX）。
將此程式碼與檔案監控服務結合，以自動化批次轉換。

常見問答

Q: 什麼是 GroupDocs.Conversion for Java？
A: 這是一個 Java 函式庫，讓開發人員能在數十種格式之間進行文件轉換，包含試算表轉 PDF。

Q: 如何在轉換時隱藏註解？
A: 在建立 Converter 前使用 SpreadsheetLoadOptions.setHideComments(true)。

Q: 我的 PDF 仍然每個工作表有多頁——哪裡出錯了？
A: 確認已套用 loadOptions.setOnePagePerSheet(true)，且已使用該選項重新初始化 Converter。

Q: 我可以進一步自訂 PDF 輸出嗎？
A: 可以，探索 PdfConvertOptions 中的其他屬性，例如 setCompress(true) 或 setMetadata(...)。

Q: 正式環境是否需要授權？
A: 正式環境需要完整授權；試用授權可用於評估。

最後更新： 2026-03-08
測試版本： GroupDocs.Conversion 25.2
作者： GroupDocs