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

将 PDF 直接嵌入 Word 文档可以显著提升协作效率，因为阅读者无需在文件之间切换。在本指南中，您将了解使用 GroupDocs.Merger for Java 如何在 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

什么是 Word 中嵌入 PDF？

将 PDF 嵌入会在 Word 文件中创建一个 OLE（Object Linking and Embedding）对象。该 PDF 保持完整功能——用户可以双击图标在 PDF 查看器中打开，同时 Word 文档保持自包含。

为什么使用 GroupDocs.Merger 将 PDF 添加到 Word？

  • 单一来源文档： Keep contracts, manuals, or reports together without external links.
  • 提升可访问性： Readers can view the PDF without leaving the Word environment.
  • 自动化友好： Perfect for generating batch reports or legal packages programmatically.
  • 可扩展： 您可以 在 Word 中嵌入多个 PDF 文档，通过重复使用相同的工作流处理每个文件。

前置条件

  • 库和依赖项： 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

要嵌入 OLE 对象，首先将库添加到项目中。

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 发布页面 下载最新版本。

许可证获取： 您可以先使用免费试用，或获取临时许可证以评估功能后再购买。访问 购买 GroupDocs 获取更多详情。

基本初始化

导入所需的类，以便处理 OLE 对象：

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

步骤指南：在 Word 中嵌入 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

通过设置尺寸来自定义嵌入 PDF 的外观。

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 oleWordsOptions = new OleWordProcessingOptions(embeddedFilePath, pageNumber);
oleWordsOptions.setWidth(300); // Width of the embedded object
oleWordsOptions.setHeight(300); // Height of the embedded object

实际应用

在许多实际场景中嵌入 PDF 非常有用：

  1. 技术手册 – 将详细的原理图或参考 PDF 直接插入指南。
  2. 财务报告 – 添加补充审计 PDF，而不打断主报告的连贯性。
  3. 法律合同 – 将附件或展品作为 OLE 对象附加，便于审阅时快速访问。
  4. 营销资料 – 将 PDF 插入 Word 小册子，以便随时查看产品规格。

性能考虑

处理大文档或多个 OLE 对象时，请注意以下提示：

  • 裁剪不必要的内容 – 仅嵌入真正需要的页面。
  • 管理内存 – 使用 Java 的 -Xmx 标志为大文件分配足够的堆空间。
  • 保持最新 – 新的 GroupDocs.Merger 版本通常包含性能优化。

常见问题及解决方案

  • 文件路径不正确： 验证 Word 和 PDF 路径是绝对路径或相对于项目根目录的正确相对路径。
  • 内存不足错误： 增加 JVM 堆大小或将文档分批处理。
  • PDF 损坏： 确保源 PDF 在查看器中能够正常打开后再进行嵌入。
  • 缺少 OLE 图标： 检查 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-02-19
测试环境： GroupDocs.Merger for Java latest version
作者： GroupDocs