如何使用 GroupDocs.Viewer for Java 將 docx 轉換為 png

簡介

如果您需要快速且可靠地 convert docx to png，GroupDocs.Viewer for Java 為您提供即用的 API，能處理複雜的版面配置、嵌入的圖像和表格，且不需要任何外部依賴。在本教學中，您將學習如何設定函式庫、配置渲染選項，並從 Word 文件產生高品質的 PNG 頁面。此方法可在支援 Java 8+ 的任何平台上運行，並能從單頁片段擴展至多百頁的報告。

使用 GroupDocs.Viewer for Java 將 DOCX 檔案轉換為 PNG

您將學習的內容

• 如何設定與配置 GroupDocs.Viewer for Java。
• 逐步說明將 DOCX 檔案渲染為 PNG 圖像的指南。
• 用於最佳圖像輸出的關鍵配置選項。
• 真實情境中，將 docx 轉換為 png 可節省時間並提升安全性。
• 實作過程中常見問題的故障排除技巧。

在開始轉換文件之前，讓我們先了解所需的前置條件！

快速回答

• 需要的函式庫版本為何？ GroupDocs.Viewer Java v25.2 或更新版本。
• 支援哪個 Java 版本？ Java 8 至 Java 21 (LTS)。
• 測試是否需要授權？ 從 GroupDocs 下載頁面取得的免費試用版可用於開發。
• 可以自訂 PNG 解析度嗎？ 可以 – 使用 PngOptions 設定 DPI 或圖像尺寸。
• 是否支援批次轉換？ 當然可以；在迴圈中遍歷頁面或檔案。

前置條件

在開始之前，請確保您具備必要的工具與知識：

必要的函式庫、版本與相依性

您需要 GroupDocs.Viewer 函式庫版本 25.2 或更新。請使用 Maven 在 Java 專案中加入此相依性。

環境設定需求

• 確保系統已安裝 JDK（Java 8 或更高版本）。
• 使用 IntelliJ IDEA 或 Eclipse 等 IDE 撰寫與執行 Java 程式碼。

知識前置條件

熟悉基本的 Java 程式概念並具備使用 Maven 建置專案的經驗將會有幫助。我們會一步步指導，即使您是這些工具的新手也沒問題。

設定 GroupDocs.Viewer for Java

若要使用 GroupDocs.Viewer，請透過 Maven 將其加入專案相依性：

Maven 設定

<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>

<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.Viewer，請考慮取得授權：

• 免費試用： 從 GroupDocs 下載頁面 下載函式庫以測試其功能。
• 臨時授權： 透過 臨時授權 取得延長評估的授權。
• 購買： 若為商業使用，請透過 GroupDocs 購買頁面 購買授權。

設定完成後，讓我們初始化並配置 GroupDocs.Viewer。

基本初始化

Viewer 是主要的類別，用於開啟文件並提供支援格式的渲染功能。

import com.groupdocs.viewer.Viewer;

try (Viewer viewer = new Viewer("path/to/SAMPLE_DOCX")) {
    // Your code to render the document will go here.
} catch (Exception e) {
    e.printStackTrace();
}

此程式碼片段會開啟文件並為渲染做準備。請將 "path/to/SAMPLE_DOCX" 替換為實際的檔案路徑。

如何將 docx 轉換為 png？

要將 DOCX 檔案轉換為 PNG，請以文件路徑建立 Viewer 實例，建立 PngOptions 物件以定義所需的解析度與輸出資料夾，然後對每個欲渲染的頁面呼叫 viewer.view(pageNumber, options)。每次呼叫都會產生 PNG 圖像並儲存至指定位置。

Viewer 類別是什麼？

Viewer 類別是 GroupDocs.Viewer 的核心元件，負責載入文件並提供多種輸出格式（如 PNG、JPEG、PDF、HTML）的渲染方法。建立 Viewer 實例後，您可以呼叫其 view 方法產生每頁的圖像或其他表示形式，並可選擇自訂 DPI 或頁面範圍等選項。

為何使用 GroupDocs.Viewer 來將 docx 轉換為 png？

GroupDocs.Viewer 支援 50+ 種輸入格式，且能在不將整個檔案載入記憶體的情況下渲染數百頁的文件，在一般伺服器等級的 CPU 上可達到每秒 30 頁 的轉換速度。這使其非常適合高吞吐量的 Web 服務與批次處理流程。

實作指南

現在，我們將分步說明如何將 DOCX 文件渲染為 PNG 圖像。

將文件渲染為 PNG 圖像

概觀
我們將配置 GroupDocs.Viewer，將 DOCX 文件的每一頁轉換為單獨的 PNG 檔案。此方式對於需要文件預覽或離線檢視功能的 Web 應用程式相當有用。

步驟 1：設定輸出目錄與選項

PngOptions 用於設定 PNG 渲染參數，例如 DPI、圖像寬度、高度以及輸出檔案命名方式。

import java.nio.file.Path;
import java.nio.file.Paths;

// Define output path for rendered PNGs
Path outputDirectory = Paths.get("YOUR_OUTPUT_DIRECTORY");
Path pageFilePathFormat = outputDirectory.resolve("page_{0}.png");

// Create view options to render as PNG
PngViewOptions viewOptions = new PngViewOptions(pageFilePathFormat);

為什麼重要： pageFilePathFormat 確保每個文件頁面以唯一的檔名儲存在指定的目錄中。

步驟 2：渲染文件

Render the DOCX file into PNG images using the configured options:

import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.PngViewOptions;

try (Viewer viewer = new Viewer("YOUR_DOCUMENT_DIRECTORY/SAMPLE_DOCX")) {
    // Convert document pages to PNG format
    viewer.view(viewOptions);
} catch (Exception e) {
    e.printStackTrace();
}

為什麼重要： view 方法會處理文件的每一頁，並依照您定義的輸出路徑將其儲存為 PNG 圖像。

常見問題與解決方案

• 缺少目錄： 程式化建立輸出資料夾，或確保在渲染前已存在。
• 檔案權限： 以足夠的權限執行 JVM，以讀取來源 DOCX 並寫入 PNG 檔案。
• 大型文件： 使用 try‑with‑resources 自動關閉 Viewer 實例並釋放記憶體。

實務應用

渲染文件為圖像格式有多種真實應用：

1. 文件存檔： 建立不可變、更改唯讀的合約或報告快照。
2. Web 預覽： 在入口網站上顯示文件縮圖，避免暴露可編輯內容。
3. 離線存取： 在無法使用 PDF 檢視器的行動應用程式中捆綁圖像。
4. 資料安全： 僅分享圖像表示，以防止意外編輯。

GroupDocs.Viewer 可與內容管理系統（CMS）整合，自動化上述流程，提升生產力與安全性。

效能考量

有效率地渲染文件對於維持應用程式效能至關重要：

優化效能的技巧

• 使用如串流等高效的檔案處理技術。
• 在不需要高保真度時限制 PNG 解析度（例如 150 DPI）。

資源使用指引

• 監控渲染期間的記憶體使用，以避免 OutOfMemoryError。
• 如程式碼片段所示，使用 try‑with‑resources 正確釋放資源。

Java 記憶體管理最佳實踐

• 透過一次處理單頁的方式，將應用程式的記憶體占用降至最低。
• 根據預期文件大小，分析並調整 JVM 設定（例如 -Xmx2g）。

常見問答

Q: 我可以使用 GroupDocs.Viewer for Java 渲染 PDF 嗎？
A: 可以，GroupDocs.Viewer 支援 PDF 以及許多其他格式；詳情請參閱 API 參考文件。

Q: 如何有效處理大型文件？
A: 將頁面分批渲染，重複使用單一 Viewer 實例，並及時關閉以釋放記憶體。

Q: 若輸出目錄不存在該怎麼辦？
A: 確認程式碼在渲染前檢查目錄，並使用 Files.createDirectories() 建立它。

Q: 是否可以自訂圖像品質或尺寸？
A: 可以，PngOptions 允許設定 DPI、圖像寬度與高度，以控制品質與檔案大小。

Q: 若遇到問題，該向何處尋求支援？
A: 前往 GroupDocs 支援論壇 獲取社群協助與官方支援。

其他資源

• GroupDocs.Viewer Java 文件
• GroupDocs API 參考文件

結論

您現在擁有使用 GroupDocs.Viewer for Java convert docx to png 的完整、可投入生產的指南。此功能不僅簡化文件分享與存檔，亦為 Web 與行動應用程式的預覽產生開啟新可能。

後續步驟

• 嘗試其他輸出格式（如 JPEG 或 SVG），只需將 PngOptions 換成相應的類別。
• 將渲染邏輯整合至 REST API，以即時提供預覽。
• 探索雲端儲存連接器，自動將產生的 PNG 上傳至 AWS S3、Azure Blob 或 Google Cloud Storage。

準備好開始了嗎？立即實作此解決方案，讓您的文件處理工作流程現代化！

最後更新： 2026-07-05
測試環境： GroupDocs.Viewer for Java v25.2
作者： GroupDocs

相關教學

• 使用 GroupDocs Viewer for Java 渲染 DOCX 為圖像：完整指南
• 如何使用 GroupDocs.Viewer for Java 將 DOCX 轉換為 HTML：逐步指南
• Java 教學：使用 GroupDocs.Viewer API 渲染特定頁面以供文件預覽與管理