使用 GroupDocs.Editor for Java 从 Word 文档中提取图片

如果您需要以编程方式 extract pictures from Word 文件，您来对地方了。在本教程中，我们将演示如何在 Java 中加载 Word 文档、配置编辑器，并提取图像、字体和 CSS——正是您在使用 GroupDocs.Editor for Java 自动化文档处理流水线时所需的步骤。

您将学习：

• 如何使用 GroupDocs.Editor load word document java
• 如何 extract images java 以及其他嵌入的资源
• 如何 extract css java 用于样式复用
• 保存这些资源到磁盘的最佳实践方法
• 提取资源可节省时间和精力的真实场景

准备好简化您的文档工作流了吗？让我们开始吧！

快速答案

• What does “extract pictures from word” mean? 这意味着以编程方式从 Word 文件中提取图像、字体、CSS 和其他嵌入的资产。
• Which library handles this in Java? GroupDocs.Editor for Java 提供了用于此任务的高级 API。
• Do I need a license? 免费试用可用于测试；生产环境需要完整许可证。
• Can I process DOCX and DOC files? 是的，两者均得到完整支持。
• Is it safe for large documents? 是的，但对于大于 200 MB 的文件，请考虑批处理和适当的内存释放。

什么是 Word 文档中的资源提取？

资源提取是指系统地检索 Word 文件中所有嵌入的资产，包括图片、定制字体、样式表、宏以及其他二进制对象。通过提取这些组件，开发者可以在其他应用中复用它们、归档以满足合规要求，或将其转换为适合 Web 的格式，从而提升原始文档的价值。

为什么使用 GroupDocs.Editor for Java？

GroupDocs.Editor for Java 抽象了 Office Open XML 格式，让您专注于 how to extract pictures from word，无需编写底层 ZIP 或 XML 代码。它支持 30+ input and output formats，并且能够处理高达 500 MB 的文档而无需将整个文件加载到内存中，提供速度和可扩展性。

前置条件

• Maven（或直接下载 JAR）用于管理依赖。
• JDK 8+ 已在您的开发机器上安装。
• 一个 IDE，例如 IntelliJ IDEA 或 Eclipse，用于编辑和运行 Java 代码。

设置 GroupDocs.Editor for Java

将仓库和依赖添加到您的 pom.xml：

<repositories>
   <repository>
      <id>repository.groupdocs.com</id>
      <name>GroupDocs Repository</name>
      <url>https://releases.groupdocs.com/editor/java/</url>
   </repository>
</repositories>

<dependencies>
   <dependency>
      <groupId>com.groupdocs</groupId>
      <artifactId>groupdocs-editor</artifactId>
      <version>25.3</version>
   </dependency>
</dependencies>

您也可以从 GroupDocs.Editor for Java releases 下载最新的 JAR。

获取许可证

• Free Trial: 适合探索 API 的完美选择。
• Temporary License: 从 GroupDocs Temporary License Page 获取。
• Full License: 购买后可在生产环境中无限制使用。

基本初始化

Editor 是 GroupDocs.Editor for Java 的主要入口点，提供加载、编辑和提取 Word 文件资源的方法。

创建指向您的 Word 文件的 Editor 实例：

String inputFilePath = "YOUR_DOCUMENT_DIRECTORY";
Editor editor = new Editor(inputFilePath, new WordProcessingLoadOptions());

如何从 Word 文档中提取资源

提取资源的过程首先将目标 Word 文件加载到 Editor 实例中，然后配置 WordProcessingEditOptions 以启用图像、字体和 CSS 的提取。文档准备好后，API 会提供每种资源类型的集合，您可以遍历这些集合并将其保存到文件系统，或根据工作流需求进一步处理。

步骤 1：加载并准备文档进行编辑

// Initialize editor and edit options
String inputFilePath = "YOUR_DOCUMENT_DIRECTORY";
Editor editor = new Editor(inputFilePath, new WordProcessingLoadOptions());
WordProcessingEditOptions editOptions = new WordProcessingEditOptions();
editOptions.setFontExtraction(FontExtractionOptions.ExtractAll);
EditableDocument beforeEdit = editor.edit(editOptions);

FontExtractionOptions.ExtractAll 标志确保每个嵌入的字体都可供提取。

步骤 2：提取图像、字体和样式表

List<IImageResource> images = beforeEdit.getImages();

List<FontResourceBase> fonts = beforeEdit.getFonts();

List<CssText> stylesheets = beforeEdit.getCss();

这三个调用为您提供每种资源类型的集合，准备进行进一步处理。

步骤 3：将提取的资源保存到磁盘

String outputFolderPath = "YOUR_OUTPUT_DIRECTORY";
for (int i = 0; i < images.size(); i++) {
    IImageResource oneImage = images.get(i);
    File outputFile = new File(outputFolderPath + oneImage.getFilenameWithExtension());
    oneImage.save(outputFile.getAbsolutePath());
}

for (int i = 0; i < fonts.size(); i++) {
    FontResourceBase oneFont = fonts.get(i);
    File outputFile = new File(outputFolderPath + oneFont.getFilenameWithExtension());
    oneFont.save(outputFile.getAbsolutePath());
}

for (int i = 0; i < stylesheets.size(); i++) {
    CssText oneStylesheet = stylesheets.get(i);
    File outputFile = new File(outputFolderPath + oneStylesheet.getFilenameWithExtension());
    oneStylesheet.save(outputFile.getAbsolutePath());
}

每个循环将相应的资源写入 outputFolderPath，并保留原始文件名。

步骤 4：直接获取资源内容（可选）

如果您需要原始字节或 Base64 字符串——例如，将图像嵌入 HTML 邮件中——请使用：

InputStream ms = images.get(0).getByteContent(); // raw bytes
String base64EncodedResource = images.get(0).getTextContent(); // Base64 string

常见问题及解决方案

常见问答

Q: GroupDocs.Editor 是否兼容所有 Word 文件格式？
A: 是的，它支持 DOCX、DOC 以及其他 Microsoft Word 格式。

Q: 我可以从受密码保护的文档中提取资源吗？
A: 当然。创建 Editor 时通过 WordProcessingLoadOptions 提供密码。

Q: API 在处理非常大的文档时表现如何？
A: 已针对速度进行优化；对于超过 200 MB 的文件，我们建议批处理或顺序提取各章节。

Q: 我可以将其与 Spring Boot 或其他 Java 框架集成吗？
A: 可以。API 与框架无关，只需加入依赖并在需要的地方注入 Editor。

Q: 如果我只需要提取图像而不提取字体或 CSS，该怎么办？
A: 只调用 beforeEdit.getImages()，跳过字体/CSS 提取步骤。

结论

您现在拥有使用 GroupDocs.Editor for Java 提取 how to extract pictures from word 文档的完整、可投入生产的完整指南。通过加载文档、配置编辑选项并遍历返回的资源集合，您可以轻松实现归档、模板创建和动态内容生成的自动化。

接下来的步骤：

• 尝试不同的 WordProcessingEditOptions 以微调提取。
• 将此工作流与云存储 SDK 结合，直接上传资源到 S3 或 Azure Blob。
• 探索 GroupDocs 转换 API，将提取的资产转换为其他格式。

最后更新： 2026-05-22
测试环境： GroupDocs.Editor 25.3 for Java
作者： GroupDocs

相关教程

• 如何从 Word 文档中提取资源 – GroupDocs.Editor Java
• 使用 GroupDocs.Editor 加载 Word 文档 Java – 完整指南