使用 GroupDocs Conversion Java 將 Excel 轉換為 PDF

您是否需要快速 convert Excel to PDF,同時保持輸出整潔且沒有空白列或欄?使用 GroupDocs Conversion Java,您只需幾行程式碼即可將任何試算表轉換為緊湊的 PDF。本教學將帶您完成庫的設定、配置載入選項以 skip empty rows and columns,以及處理大規模報告管線的批次轉換。完成後,您將能夠:

  • 將 GroupDocs Conversion Java 依賴項加入 Maven 專案
  • 使用 SpreadsheetLoadOptions.setSkipEmptyRowsAndColumns(true) 以移除空白
  • 將工作簿轉換為 PDF,達到最佳效能
  • 將解決方案擴展至自動化、批次式 Excel‑to‑PDF 工作流程

讓我們深入了解 groupdocs conversion java 如何輕鬆實現此功能。

快速解答

  • 什麼函式庫負責轉換? GroupDocs Conversion Java
  • 使用的主要功能? SpreadsheetLoadOptions.setSkipEmptyRowsAndColumns(true)
  • 最低 Java 版本? JDK 8 或更高
  • 能處理大量檔案嗎? 是 – 可將此程式碼與批次邏輯結合以進行大量轉換
  • 需要授權嗎? 生產環境需要臨時或試用授權

什麼是「convert excel to pdf」?

將 Excel 轉換為 PDF 意味著將試算表檔案(例如 .xlsx 或 .xls)轉換為固定版面的 PDF 文件。產生的 PDF 完全保留原始工作簿的外觀,包括字型、顏色和儲存格格式,因而在任何裝置或作業系統上皆顯示相同。此格式非常適合安全分享、高品質列印及長期保存。

什麼是 GroupDocs Conversion Java?

GroupDocs Conversion Java 是基於 Java 的 SDK,支援 50+ input and output formats,包括 Excel、Word、PowerPoint 及影像,且能在不將整個檔案載入記憶體的情況下處理數百頁的文件。它提供高階 API,抽象化格式特定的複雜性,使開發人員能專注於業務邏輯而非檔案處理。

為何在此任務中使用 GroupDocs Conversion Java?

GroupDocs Conversion Java 提供 quantified benefits:它支援超過 50 種格式,處理最高達 1 GB 的檔案且堆疊使用量低於 200 MB,並能在標準伺服器上於 0.8 秒內將典型的 200 列工作表轉換為 PDF。此函式庫亦提供:

  • Smart loading options(例如 skip empty rows/columns)可將 PDF 大小縮減最高 30 %
  • One‑page‑per‑sheet 轉換,產生精簡的 PDF
  • Cross‑platform compatibility – 可在 Windows、Linux 與 macOS 上運作
  • Batch processing support 用於大規模自動化

先決條件

在我們深入程式碼之前,請確保您已具備:

  1. Java Development Kit (JDK) 8+ – 從 Oracle’s website 下載
  2. Maven – 從 maven.apache.org 取得
  3. GroupDocs Conversion 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 Java 將 Excel 轉換為 PDF?

要使用 GroupDocs Conversion Java 將 Excel 工作簿轉換為 PDF,首先使用適當的載入選項載入工作簿,啟用 setSkipEmptyRowsAndColumns(true) 旗標以移除空白儲存格,接著建立 Converter 實例並指定 PdfConvertOptions。最後,呼叫 convert 方法寫入 PDF 檔案。整個工作流程分為四個簡單步驟。

步驟 1:設定載入選項

SpreadsheetLoadOptions 定義試算表的解析方式。設定 setSkipEmptyRowsAndColumns(true) 會告訴引擎忽略所有未包含資料的列或欄,從而產生更緊湊的 PDF 版面。

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

String inputFilePath = "YOUR_DOCUMENT_DIRECTORY/sample.xlsx"; // Input file path

// Configure load options to skip empty rows and columns and set one page per sheet.
SpreadsheetLoadOptions loadOptions = new SpreadsheetLoadOptions();
loadOptions.setSkipEmptyRowsAndColumns(true);
loadOptions.setOnePagePerSheet(true);

說明: SpreadsheetLoadOptions 控制試算表的讀取方式。啟用 setSkipEmptyRowsAndColumns(true) 會移除空白空間,產生更緊湊的 PDF。

步驟 2:初始化 Converter

Converter 是負責協調從來源到目標格式轉換的核心類別。透過傳遞提供先前定義的 loadOptions 的 lambda,您可確保每次轉換皆使用相同設定。

import com.groupdocs.conversion.Converter;

// Initialize the converter with the input file path and load options.
Converter converter = new Converter(inputFilePath, () -> loadOptions);

說明: 只要 converter 需要載入文件時,lambda 便會提供先前定義的 loadOptions

步驟 3:準備 PDF 轉換選項

PdfConvertOptions 讓您微調 PDF 輸出,例如邊距、頁面大小與影像品質。預設值適用於大多數情況,但您可依品牌或合規需求進行調整。

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

// Create PdfConvertOptions (optional, as default options are used here).
PdfConvertOptions pdfConvertOptions = new PdfConvertOptions();

說明: PdfConvertOptions 讓您調整邊距、頁面大小以及其他 PDF 專屬設定。

步驟 4:執行轉換

呼叫 convert 會將 PDF 寫入指定路徑。由於啟用了 skip‑empty‑rows/columns 設定,產生的檔案僅包含有資料的儲存格,顯著減少檔案大小。

String outputFilePath = "YOUR_OUTPUT_DIRECTORY/converted.pdf"; // Output file path

// Perform the conversion from spreadsheet to PDF.
converter.convert(outputFilePath, pdfConvertOptions);

說明: 由於使用了 skip‑empty‑rows/columns 選項,convert 方法產生的 PDF 僅包含有資料的儲存格。

常見問題與故障排除

  • Incorrect file path – 請再次確認輸入與輸出路徑。
  • Permission errors – 確保 Java 程序對目錄具有讀寫權限。
  • Large workbooks – 分配更多堆積記憶體 (-Xmx2g) 以避免 OutOfMemoryError

實務使用案例

  • Automated report generation – 將每日 Excel 報告轉換為精美 PDF,供利害關係人使用。
  • Document archiving – 將財務報表以 PDF 形式保存,避免空白儲存格的雜訊。
  • Batch excel pdf conversion – 迭代資料夾中的試算表,套用相同邏輯以進行大量處理。

效能技巧

  • Memory management – 每次轉換後釋放 Converter 物件 (converter.close())。
  • Batch processing – 將檔案分批處理,以保持記憶體使用量可預測。
  • Monitoring – 記錄轉換時間與記憶體消耗,以找出瓶頸。

結論

您現在擁有完整且可投入生產環境的 convert Excel to PDF 方法,使用 GroupDocs Conversion Java 並自動移除空白列與欄。將此模式整合至您的報告管線、文件管理系統,或任何需要乾淨 PDF 輸出的情境中。

常見問答

Q1: 我可以使用 GroupDocs Conversion Java 轉換其他文件類型嗎?
A1: 可以!此 SDK 支援 50+ 種格式,包括 Word、PowerPoint 與影像,提供單一解決方案以滿足多樣的轉換需求。

Q2: PDF 仍顯示空白列——我應該檢查什麼?
A2: 確認在建立 Converter 實例之前已呼叫 loadOptions.setSkipEmptyRowsAndColumns(true)

Q3: 如何在轉換過程中處理例外情況?
A3: 將轉換程式碼包裹在 try‑catch 區塊中,記錄例外細節,並可選擇重新嘗試或跳過有問題的檔案。

Q4: 我可以自訂 PDF 版面(邊距、方向)嗎?
A4: 當然可以。使用 PdfConvertOptions 設定邊距、頁面大小、方向,甚至嵌入自訂字型。

Q5: GroupDocs Conversion 能在非 Maven 專案中使用嗎?
A5: 可以,您可直接從 GroupDocs Releases Page 下載 JAR 檔案。


最後更新: 2026-05-16
測試版本: GroupDocs Conversion 25.2
作者: GroupDocs

相關教學