使用 GroupDocs Viewer for Java 将 DOCX 转换为 JPEG

将 DOCX 转换为 JPEG 使您能够以轻量级图像的形式共享文档页面，这些图像在浏览器和电子邮件客户端中显示一致。在本指南中，您将了解如何使用 GroupDocs.Viewer for Java 将 Word 文件转换为高质量 JPEG 图像，定制尺寸，并高效管理资源。

使用 GroupDocs.Viewer for Java 渲染 DOCX 为图像

使用 GroupDocs.Viewer for Java 渲染 DOCX 为图像

快速答案

  • 哪个库处理 DOCX → JPEG 转换？ GroupDocs.Viewer for Java。
  • 需要多少行代码？ 只需两行代码即可加载并渲染文件。
  • 我可以设置自定义图像尺寸吗？ 可以，通过 JpgViewOptions 可以定义宽度和高度。
  • 生产环境是否需要许可证？ 需要商业许可证；提供免费试用。
  • 它能处理大文档吗？ 能，它可以处理最多 500 页的文件，同时保持内存使用低于 200 MB。

什么是 “convert docx to jpeg”？

将 DOCX 文件转换为 JPEG 会为每页生成一张图像，保留原始布局、字体和图形。每个 JPEG 可在浏览器中显示、嵌入电子邮件或用作缩略图。该格式轻量、支持广泛，是在无需 Microsoft Word 或额外插件的情况下预览文档的理想选择。

为什么在此转换中使用 GroupDocs Viewer for Java？

GroupDocs.Viewer 支持 50+ 输入和输出格式，并能在标准服务器硬件上以 每页不足 2 秒 的速度渲染最多 500 页 的文档。该 API 在未安装 Microsoft Office 的情况下工作，保证布局一致且内存占用低。

前提条件

  • Java Development Kit 8 或更高版本。
  • Maven 用于依赖管理（或手动包含 JAR）。
  • GroupDocs.Viewer for Java 库（可从官方网站下载）。
  • 对 Java 项目结构有基本了解。

设置 GroupDocs Viewer for Java

要将库添加到 Maven 项目中，请在 pom.xml 中插入以下依赖：

<repositories>
   <repository>
      <id>repository.groupdocs.com</id>
      <name>GroupDocs Repository</name>
      <url>https://releases.groupdocs.com/viewer/java/</url>
   </repository>
</repositories>
<dependencies>
   <dependency>
      <groupId>com.groupdocs</groupId>
      <artifactId>groupdocs-viewer</artifactId>
      <version>25.2</version>
   </dependency>
</dependencies>

获取许可证

GroupDocs 提供免费试用以探索功能。若需长期使用，请通过官方站点获取临时或正式购买的许可证。

如何将 DOCX 转换为 JPEG？

Viewer 类读取文档并提供渲染功能。
JpgViewOptions 配置 JPEG 输出设置，如尺寸、质量和文件命名。

要进行转换，实例化一个指向 DOCX 路径的 Viewer，创建指向输出文件夹的 JpgViewOptions，可选地设置尺寸和质量，然后调用 viewer.view(options)。库会处理每页并按照指定的命名模式保存 JPEG 文件。

实施指南

将 DOCX 渲染为 JPEG

将 Word 文档转换为 JPEG 图像，以便预览或共享。

步骤实现

1. 设置输出目录
定义渲染后的 JPEG 将保存的文件夹：

import com.groupdocs.viewer.Viewer;

public class DocumentRenderer {
    public static void main(String[] args) {
        try (Viewer viewer = new Viewer("path/to/your/document.docx")) {
            // Configuration and rendering logic goes here
        }
    }
}

2. 指定文件路径格式
创建包含页码的命名模式，例如 page_{0}.jpg：

import java.nio.file.Path;

// Define output directory using Path API
Path outputDirectory = YOUR_OUTPUT_DIRECTORY.resolve("rendered_document");

3. 配置图像选项
JpgViewOptions 允许设置宽度、高度和质量。例如，1024 × 768 像素，质量 90%：

Path pageFilePathFormat = outputDirectory.resolve("page_{0}.jpg");

4. 渲染文档
使用 try‑with‑resources 块确保 Viewer 实例自动关闭，释放本机资源并防止内存泄漏：

import com.groupdocs.viewer.options.JpgViewOptions;

// Create JpgViewOptions with specified path format
JpgViewOptions viewOptions = new JpgViewOptions(pageFilePathFormat);

// Set custom width and height for each image
viewOptions.setWidth(600);  // Image width in pixels
viewOptions.setHeight(800); // Image height in pixels

常见问题与解决方案

  • 文件路径问题 – 确认输出目录存在且应用程序具有写入权限。
  • 内存管理 – 对于超过 300 页的文档，考虑分批处理页面，并在每批后调用 System.gc()。
  • 不受支持的元素 – 某些高级 Word 功能（例如嵌入的宏）在渲染时会被忽略；它们不会影响视觉输出。

实际应用

  1. 预览生成 – 在内容管理系统中显示文档缩略图，无需全屏查看器。
  2. 电子邮件附件 – 在电子邮件中嵌入逐页 JPEG，以避免附件大小限制。
  3. 网页显示 – 将页面渲染为图像，以在低带宽连接下快速加载。

性能考虑因素

  • 资源管理 – 始终使用 try‑with‑resources 关闭 Viewer。
  • 图像尺寸 – 较小的尺寸可降低 RAM 使用；选择满足视觉质量要求的最小尺寸。
  • 异步处理 – 对于批量转换，将渲染任务放在单独的线程池中运行，以保持 UI 响应。

常见问题

Q: 如何处理超过 500 页的文档？
A: DocumentSplitter 允许将大文档拆分为多个部分以便更易处理。使用 DocumentSplitter 将源文件拆分为更小的段后再渲染，或按顺序批量处理页面以保持低内存使用。

Q: 我可以输出 PNG 而不是 JPEG 吗？
A: 可以，将 JpgViewOptions 替换为 PngViewOptions 并相应调整文件路径模式。

Q: 开发构建是否必须使用许可证？
A: 免费试用许可证可用于评估和开发，但生产部署需要商业许可证。

Q: 库是否支持受密码保护的 DOCX 文件？
A: 完全支持。将密码传递给 Viewer 构造函数即可在渲染前解锁文档。

Q: 支持哪些 Java 版本？
A: GroupDocs.Viewer for Java 兼容 Java 8、11 和 17。

资源

最后更新： 2026-06-05
测试环境： GroupDocs.Viewer 23.12 for Java
作者： GroupDocs

try (Viewer viewer = new Viewer("YOUR_DOCUMENT_DIRECTORY/SAMPLE_DOCX")) {
    viewer.view(viewOptions);
}

相关教程