如何使用 GroupDocs.Merger for Java 在 Word 中嵌入 PDF

直接在 Word 文件中嵌入 PDF 可以大幅提升協作效率，因為讀者不再需要在檔案之間切換。在本指南中，您將了解 如何在 Word 中嵌入 PDF，並看到關於 將 PDF 加入 Word 工作流程的實用技巧。我們將從設定函式庫到自訂 OLE 物件的大小與位置逐步說明，讓您能自信地自動化文件建立。

快速解答

  • 需要的函式庫是什麼？ GroupDocs.Merger for Java (latest version)
  • 我可以嵌入任何檔案類型嗎？ 是 – PDFs、圖片、試算表等，作為 OLE 物件
  • 我需要授權嗎？ 免費試用可用於開發；正式環境需要商業授權
  • 哪個 Java IDE 最適合？ IntelliJ IDEA、Eclipse，或任何支援 Maven/Gradle 的 IDE
  • 實作需要多長時間？ 基本嵌入大約需要 10‑15 分鐘

什麼是 Word 中嵌入 PDF？

將 PDF 嵌入會在 Word 檔案中建立 OLE（Object Linking and Embedding）物件，允許直接從文件開啟 PDF。嵌入的檔案保留原始的格式與互動性，而 Word 文件則保持為單一、獨立的封裝。此方式簡化了分發流程，確保版本一致性，並讓讀者能即時存取補充資料，而無需離開 Word 環境。

為何使用 GroupDocs.Merger 在 Word 中加入 PDF？

使用 GroupDocs.Merger 嵌入 PDF 可提供程式化、可重複的文件合併方式，無需手動編輯。函式庫會自動處理 OLE 插入、大小調整與定位，節省時間並降低人為錯誤。它亦支援批次處理，讓您能在一次執行中於多個 Word 檔案嵌入數十個 PDF，十分適合大規模文件、合約或行銷套件。

前置條件

  • 函式庫與相依性： 透過 Maven 或 Gradle 引入 GroupDocs.Merger 函式庫。
  • 開發環境： IntelliJ IDEA、Eclipse，或任何 Java IDE。
  • 基礎知識： 熟悉 Java 與文件操作概念。

如何設定 GroupDocs.Merger for Java？

首先，使用您偏好的建置工具將 GroupDocs.Merger 函式庫加入專案。該函式庫提供處理 OLE 所需的所有類別，包括 Merger、OleWordProcessingOptions 以及相關工具。相依性解決後，即可開始建立 Merger 實例，並以程式方式操作 Word 文件。

Maven

將以下相依性加入您的 pom.xml 檔案：

<dependency>
    <groupId>com.groupdocs</groupId>
    <artifactId>groupdocs-merger</artifactId>
    <version>latest-version</version>
</dependency>

Gradle

將以下內容加入您的 build.gradle 檔案：

implementation 'com.groupdocs:groupdocs-merger:latest-version'

直接下載

或者，從 GroupDocs.Merger for Java 釋出頁面 下載最新版本。

授權取得： 您可以使用免費試用版開始，或取得臨時授權以評估功能，之後再購買。請前往 Purchase GroupDocs 了解更多細節。

基本初始化如何運作？

Merger 類別是 GroupDocs.Merger for Java 中所有文件處理操作的入口。建立 Merger 實例後，您可以呼叫如 importDocument 等方法來嵌入 OLE 物件。匯入所需的類別以便操作 OLE 物件：

import com.groupdocs.merger.Merger;
import com.groupdocs.merger.domain.options.OleWordProcessingOptions;

如何一步步將 PDF 嵌入 Word 文件？

嵌入 PDF 包含載入來源 Word 檔案、指定 PDF 路徑、設定視覺選項，最後呼叫 importDocument 方法插入 OLE 物件。importDocument 方法接受來源文件、要嵌入的檔案，以及定義大小、對齊與顯示模式的 OleWordProcessingOptions 實例。此流程確保 PDF 以所需的外觀正確顯示於指定位置。

步驟 1：定義檔案路徑與目標頁面

設定來源 Word 文件、欲嵌入的 PDF，以及 OLE 物件顯示的位置。

String sourceFilePath = "YOUR_DOCUMENT_DIRECTORY/sample.docx"; // Source Word document path
String embeddedFilePath = "YOUR_DOCUMENT_DIRECTORY/sample.pdf"; // File to be embedded as an OLE object
String outputFilePath = new File("YOUR_OUTPUT_DIRECTORY",
    "ImportDocumentToWordProcessing-" + Paths.get(sourceFilePath).getFileName().toString()).getPath();
int pageNumber = 2; // Page number where the OLE object will be inserted
  • sourceFilePath – 現有 Word 檔案的路徑。
  • embeddedFilePath – 您想 將 PDF 加入 Word 的 PDF 檔案。
  • outputFilePath – 新文件將儲存的位置。
  • pageNumber – 將放置 OLE 物件的頁碼。

步驟 2：設定 OleWordProcessingOptions

OleWordProcessingOptions 類別定義 OLE 物件在 Word 文件中的外觀。您可以設定寬度、高度、對齊方式，甚至說明文字。

OleWordProcessingOptions oleWordsOptions = new OleWordProcessingOptions(embeddedFilePath, pageNumber);
oleWordsOptions.setWidth(300); // Set width of the embedded object (in points)
oleWordsOptions.setHeight(300); // Set height of the embedded object (in points)
  • setWidth() / setHeight() – 控制 PDF 圖示在 Word 文件中的顯示大小。

步驟 3：初始化 Merger 並匯入 OLE 物件

為來源文件建立 Merger 實例，匯入 OLE 物件，並儲存結果。

Merger merger = new Merger(sourceFilePath);
{
    merger.importDocument(oleWordsOptions); // Embed the OLE object into the Word document
    merger.save(outputFilePath); // Save changes to a new output file
}
  • importDocument() – 接受 OleWordProcessingOptions，將 PDF 插入為 OLE 物件。
  • save() – 將修改後的文件寫入 outputFilePath。

步驟 4：（可選）重新套用設定以加入更多物件

如果需要嵌入更多 PDF，請使用新的檔案路徑與頁碼重複 步驟 1‑3。相同的 OleWordProcessingOptions 類別可讓您個別控制每個物件。

如何為進階情境設定 OleWordProcessingOptions？

OleWordProcessingOptions 是 OLE 嵌入的設定中心。您可以將物件對齊左側、置中或右側，於下方加入說明文字，甚至指定嵌入檔案是以圖示或預覽方式顯示。以下程式碼片段重複基本設定以示說明：

OleWordProcessingOptions oleWordsOptions = new OleWordProcessingOptions(embeddedFilePath, pageNumber);
oleWordsOptions.setWidth(300); // Width of the embedded object
oleWordsOptions.setHeight(300); // Height of the embedded object

嵌入 PDF 至 Word 的實務應用有哪些？

在許多專業情境中，嵌入 PDF 非常有價值，因為它能將相關內容集中於同一文件，同時保留每個檔案的原始格式。例如，技術手冊可包含詳細圖表，財務報告可附上審計聲明，法律合約可嵌入附件，行銷手冊可納入產品規格表——全部不需額外下載或外部連結。

大型文件的效能考量有哪些？

在處理大型 Word 檔或多個 OLE 物件時，需有效管理記憶體與 I/O。修剪不必要的內容、僅嵌入所需頁面，並使用 -Xmx 參數配置足夠的 JVM 堆積空間。此外，請保持 GroupDocs.Merger 函式庫為最新版本，因為新版本常包含效能提升，可減少大量嵌入 PDF 文件的處理時間與記憶體使用。

常見問題與解決方式

典型問題包括檔案路徑不正確、記憶體不足錯誤、來源 PDF 損毀，以及缺少 OLE 圖示。請確保 Word 與 PDF 的路徑為絕對路徑或相對於專案根目錄正確，對大型批次增加 JVM 堆積大小，確認每個 PDF 在嵌入前能正常開啟，並確認目標 Word 範本允許 OLE 插入。調整這些因素通常能解決大多數嵌入失敗的情況。

常見問答

Q: 什麼是 OLE 嵌入？
A: 嵌入允許您將 PDF 等物件以連結形式插入 Word 文件，並保留其原始功能。

Q: 我可以在同一文件中嵌入多個 OLE 物件嗎？
A: 可以，每個物件可使用獨立的 OleWordProcessingOptions 設定不同頁面與大小。

Q: 嵌入檔案的大小有上限嗎？
A: 限制通常由 Word 本身的限制決定，但 GroupDocs.Merger 能有效處理大型檔案。

Q: 如何解決嵌入錯誤？
A: 確認檔案路徑正確且 JVM 記憶體足夠。檢查來源 PDF 是否損毀。

Q: 插入後我可以修改嵌入的物件嗎？
A: 您可以在 Microsoft Word 中重新開啟該 Word 檔並編輯 OLE 物件，或使用更新的選項重新執行 Merger 程式碼。

其他資源

最後更新： 2026-06-21
測試環境： GroupDocs.Merger for Java latest version
作者： GroupDocs

相關教學