每張工作表一頁：將 Excel 隱藏工作表轉換為 PDF（Java）

將 Excel 活頁簿轉換為 PDF 並保留每一個工作表（包括隱藏的工作表）可能是一項挑戰。在本教學中，您將學習使用 GroupDocs.Conversion for Java 進行 每張工作表一頁 的轉換，確保資料不會遺漏。我們將逐步說明設定、配置以及所需的完整程式碼，並提供此方法在實務情境中的應用示例。

快速解答

  • 可以包含隱藏工作表嗎？ 可以——設定 setShowHiddenSheets(true)。
  • 會產生多少 PDF 頁面？ 使用 setOnePagePerSheet(true) 時，每張工作表對應一頁。
  • 需要哪個 Java 版本？ JDK 8 或以上。
  • 需要授權嗎？ 免費試用可用於測試；正式環境需購買商業授權。
  • Maven 是唯一的建置工具嗎？ 範例使用 Maven，亦可使用 Gradle。

什麼是「每張工作表一頁」？

每張工作表一頁 選項會指示轉換器將 Excel 檔案的每個工作表渲染到單獨的 PDF 頁面。此版面配置非常適合報告、稽核，以及任何需要逐頁檢視原始活頁簿的情境。

為什麼使用 GroupDocs.Conversion for Java？

  • 完整控制 隱藏內容、頁面版面與輸出格式。
  • 跨平台 相容性，支援 Windows、Linux 與 macOS。
  • 不需外部 Office 安裝——純 Java 函式庫。
  • 彈性授權 選項，支援試用、臨時或永久使用。

前置條件

  • Java Development Kit (JDK) 8+
  • Maven（用於相依管理）
  • GroupDocs.Conversion for Java（版本 25.2 或更新）
  • 具備基本的 Java 與 Maven 知識

設定 GroupDocs.Conversion for Java

將 GroupDocs 的儲存庫與相依項目加入您的 pom.xml。此步驟可確保 Maven 能下載所需的函式庫。

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

取得授權

若要評估 API，請先使用免費試用版。正式環境則需購買授權——可從官方商店取得：

GroupDocs Purchase

實作指南

以下提供完整且可執行的 Java 程式碼，將 Excel 檔案（包含隱藏工作表）轉換為 PDF，且每個工作表會顯示於單獨的頁面上。

步驟 1：定義來源文件路徑

將轉換器指向包含隱藏工作表的 Excel 活頁簿。

String sourceDocumentPath = "YOUR_DOCUMENT_DIRECTORY/SAMPLE_XLSX_WITH_HIDDEN_SHEET";

步驟 2：設定載入選項

啟用隱藏工作表處理與每張工作表一頁的版面配置。

SpreadsheetsLoadOptions loadOptions = new SpreadsheetsLoadOptions();
loadOptions.setShowHiddenSheets(true); // Include hidden sheets
loadOptions.setOnePagePerSheet(true);   // One page per sheet in PDF output

步驟 3：初始化 Converter

使用來源路徑與載入選項建立 Converter 實例。

Converter converter = new Converter(sourceDocumentPath, () -> loadOptions);

步驟 4：設定轉換選項

準備 PDF 轉換的設定。

PdfConvertOptions convertOptions = new PdfConvertOptions();

步驟 5：執行轉換

執行轉換，並將 PDF 輸出至指定位置。

String outputFilePath = "YOUR_OUTPUT_DIRECTORY/ConvertSpreadsheetWithHiddenSheetsIncluded.pdf";
converter.convert(outputFilePath, convertOptions);

主要設定回顧

  • setShowHiddenSheets(true)：讓隱藏的工作表對轉換器可見。
  • setOnePagePerSheet(true)：確保每個工作表產生獨立的 PDF 頁面。

疑難排解技巧

  • 檔案未找到錯誤： 請再次確認您提供的絕對或相對路徑。
  • 相依衝突： 確認 Maven 坐標與您安裝的版本相符。
  • 大型活頁簿的記憶體問題： 若出現 OutOfMemoryError，請增加 JVM 堆積大小（-Xmx）。

實務應用

  1. 財務報告： 匯出完整活頁簿（包括隱藏的計算工作表）為 PDF，以作為稽核追蹤。
  2. 資料稽核： 在歸檔試算表時保留所有隱藏的資料集。
  3. 專案文件： 產生與原始 Excel 版面相同的整潔逐頁 PDF，供利害關係人審閱。

效能考量

  • 大型活頁簿： 分批處理工作表或增加堆積記憶體以避免瓶頸。
  • 串流輸出： 在 Web 服務中使用 converter.convert(OutputStream, convertOptions) 進行即時產生。
  • 資源清理： 轉換完成後呼叫 converter.close() 釋放原生資源。

結論

現在您已掌握使用 GroupDocs.Conversion for Java 進行 每張工作表一頁 轉換（包括隱藏工作表）的技巧。此方法可確保所有資料皆匯入最終的 PDF，讓您在報告、稽核與文件編制上更有信心。

後續步驟

  • 嘗試其他 PdfConvertOptions（例如影像壓縮、PDF/A 相容性）。
  • 將此轉換流程整合至更大型的 Java 服務或 Spring Boot 應用程式中。
  • 探索其他格式（Word、PowerPoint）的相似隱藏內容處理方式。

常見問答

  1. 轉換隱藏工作表有什麼好處？

    • 確保文件完整，避免遺漏關鍵細節。

  2. 我可以使用 GroupDocs.Conversion 轉換其他檔案格式嗎？

    • 可以，它支援除 Excel 與 PDF 之外的多種格式。

  3. 如何排除轉換錯誤？

    • 檢查檔案路徑、確認 Maven 相依版本，並參考官方文件中的錯誤代碼。

  4. 轉換工作表的數量有上限嗎？

    • 通常沒有，但極大型的活頁簿可能需要更多記憶體。

  5. GroupDocs.Conversion 如何處理大型 Excel 檔案？

    • 它使用高效的串流與記憶體管理技術，您亦可進一步調整 JVM 設定。

資源

最後更新： 2026-01-08
測試環境： GroupDocs.Conversion 25.2 for Java
作者： GroupDocs