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

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

快速答案

  • 需要哪個函式庫？ GroupDocs.Merger for Java (latest version)
  • 我可以嵌入任何檔案類型嗎？ Yes – PDFs, images, spreadsheets, etc., as OLE objects
  • 我需要授權嗎？ A free trial works for development; a commercial license is required for production
  • 哪個 Java IDE 最適合？ IntelliJ IDEA, Eclipse, or any IDE that supports Maven/Gradle
  • 實作需要多長時間？ Roughly 10‑15 minutes for a basic embed

什麼是 PDF 嵌入 Word？

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

為什麼使用 GroupDocs.Merger 將 PDF 添加到 Word？

GroupDocs.Merger 自動化 OLE 插入、尺寸調整與定位，省去手動編輯的需求。該函式庫支援超過 30+ 輸入與輸出格式，且可在單一批次中嵌入 數百個 PDF，同時在一般 JVM 上將記憶體使用量控制在 200 MB 以下。此可擴展性使其非常適合大規模文件、合約或行銷套件。

前置條件

  • 函式庫與相依性： Include the GroupDocs.Merger library via Maven or Gradle.
  • 開發環境： IntelliJ IDEA, Eclipse, or any Java IDE.
  • 基礎知識： Familiarity with Java and document‑manipulation concepts.

如何設定 GroupDocs.Merger for Java？

首先，使用 Maven、Gradle 或手動下載 JAR，將 GroupDocs.Merger 函式庫加入專案。相依性解決後，匯入核心類別，例如 Merger、OleWordProcessingOptions 以及任何必要的 I/O 工具。確保您的專案目標為 Java 8 或更高版本，且函式庫版本與授權相符。

Maven

Add this dependency to your pom.xml file:

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

Gradle

Include this in your build.gradle file:

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

直接下載

或者，從 GroupDocs.Merger for Java releases page 下載最新版本。

License acquisition: 您可以先使用免費試用版，或取得臨時授權以評估功能再購買。請前往 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 檔案、建立 OleWordProcessingOptions 實例以定義外觀，並以 PDF 路徑與選項呼叫 importDocument。函式庫會在指定位置插入 OLE 物件，之後您儲存文件即可產生自包含檔案。

步驟 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 控制嵌入物件的視覺呈現。您可以將物件對齊左側、置中或右側，於下方加入說明文字，甚至指定嵌入檔案是以圖示或預覽方式顯示。

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 版本可將超過 200 頁 文件的處理速度提升 最高 35 %，且相較於早期版本，峰值記憶體使用量降低 約 40 %。

常見問題與解決方法有哪些？

常見問題包括檔案路徑不正確、記憶體不足錯誤、來源 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-10-27
測試環境： GroupDocs.Merger for Java latest version
作者： GroupDocs

相關教學