如何使用 GroupDocs.Editor for Java 編輯 DOCX 並提取資源

介紹

如果您需要以程式方式 從 docx 中提取圖像，同時取得內嵌資源，您來對地方了。在本教學中，我們將示範如何使用 GroupDocs.Editor for Java 來編輯 Word 文件、提取圖像、字體與樣式表，甚至處理多檔案的批次作業。無論您是在建置內容管理入口網站、數位資產管線，或是自訂報表引擎，這些技巧都能為您節省時間並保持程式碼整潔。

快速解答

  • 如何編輯 docx？ 使用 Editor.edit() 搭配 WordProcessingEditOptions。
  • 如何從 docx 提取圖像？ 呼叫 document.getImages() 並儲存每個 IImageResource。
  • 我可以從 docx 提取字體嗎？ 可以——使用 document.getFonts() 並儲存 FontResourceBase 物件。
  • 支援批次處理嗎？ 在迴圈中處理檔案清單；GroupDocs.Editor 會獨立處理每個檔案。
  • 需要授權嗎？ 生產環境必須使用臨時或試用授權。

為何要從 docx 提取圖像？

提取圖像可直接取得 Word 檔案中嵌入的視覺資產。當您需要將圖形重新用於網站相簿、遷移至數位資產管理系統，或僅將它們與文件內容分開存檔時，這特別有用。

什麼是使用 GroupDocs.Editor 的「如何編輯 docx」？

GroupDocs.Editor 提供高階 API，抽象化 Office Open XML 格式的複雜性。只要將 .docx 檔載入 Editor 實例，即可完整讀寫文件內容與其內嵌資源。

為何在 Java 應用程式中使用 GroupDocs.Editor 編輯 Word 文件？

  • 不需安裝 Office – 可在任何伺服器端環境執行。
  • 豐富的資源提取 – 只需幾行程式碼即可抽取圖像、字體與 CSS 樣式表。
  • 可擴充的批次處理 – 一次執行即可處理數十個檔案，且不會發生記憶體洩漏。
  • 跨平台 – 相容於 JDK 8+ 以及任何基於 Maven 的專案。

先決條件

  • Java Development Kit (JDK) 8 或更高版本
  • Maven 用於相依性管理
  • 基本的 Java 專案結構概念

設定 GroupDocs.Editor for Java

Maven 設定

將儲存庫與相依性加入您的 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>

直接下載

如果您不想使用 Maven，可從 GroupDocs releases 下載最新版本的 GroupDocs.Editor for Java。

取得授權

開始使用 GroupDocs.Editor 前，請取得免費試用或臨時授權。您可在 GroupDocs 的網站 申請臨時授權。依照提供的說明在程式碼中套用授權。

基本初始化與設定

加入函式庫後，建立指向 Word 檔案的 Editor 實例：

Editor editor = new Editor("YOUR_DOCUMENT_DIRECTORY/sample.docx", new WordProcessingLoadOptions());

現在您已準備好 編輯 word document java 風格。

實作指南

我們將把實作分成多個獨立功能，每個功能聚焦於 GroupDocs.Editor for Java 的特定用途。

如何使用 GroupDocs.Editor for Java 編輯 DOCX

概述

載入並編輯文件是第一步。此功能讓使用者能在應用程式內直接檢視與修改內容。

步驟 1：建立 Editor 物件
// Initialize the Editor with the path to your Word file.
Editor editor = new Editor("YOUR_DOCUMENT_DIRECTORY/sample.docx", new WordProcessingLoadOptions());
步驟 2：編輯文件

使用 edit() 方法取得可操作的 EditableDocument：

EditableDocument document = editor.edit(new WordProcessingEditOptions());

如何從 DOCX 提取圖像

概述

當您需要重新使用或將視覺素材獨立存檔時，提取圖像是關鍵步驟。

步驟 1：取得圖像
// Get the list of image resources in the document.
List<IImageResource> images = document.getImages();

儲存圖像至資料夾

概述

提取完成後，您可以將圖像存放在任意需要的位置。

步驟 2：儲存提取的圖像
String outputFolder = "YOUR_OUTPUT_DIRECTORY";

for (IImageResource oneImage : images) {
    // Save each image with its original name and extension.
    oneImage.save(outputFolder + oneImage.getFilenameWithExtension());
}

如何從 DOCX 提取字體

概述

字體常被嵌入以維持品牌形象；提取字體可確保跨平台的視覺一致性。

步驟 1：取得字體
// Obtain a list of font resources within the document.
List<FontResourceBase> fonts = document.getFonts();

儲存字體至資料夾

概述

將提取的字體持久化，以便在設計工具或其他文件中使用。

步驟 2：儲存提取的字體
for (FontResourceBase oneFont : fonts) {
    // Store each font resource with its original name and extension.
    oneFont.save(outputFolder + oneFont.getFilenameWithExtension());
}

如何從 DOCX 提取樣式表

概述

樣式表（CSS）定義視覺版面。將其抽出後，可在網站或其他文件格式中重複使用樣式。

步驟 1：取得樣式表
// Access the list of CSS text resources in the document.
List<CssText> stylesheets = document.getCss();

儲存樣式表至資料夾

概述

儲存 CSS 檔案可讓您在 Word 之外完整掌控文件樣式。

步驟 2：儲存提取的樣式表
for (CssText oneStylesheet : stylesheets) {
    // Preserve each stylesheet with its original name and extension.
    oneStylesheet.save(outputFolder + oneStylesheet.getFilenameWithExtension());
}

實務應用

  1. 數位資產管理 – 提取圖像以建立集中式資源庫。
  2. 品牌一致性 – 抽取字體，確保所有企業文件的品牌統一。
  3. 自訂文件範本 – 重用提取的樣式表，打造自動化報表的統一範本。
  4. 批次處理 Word 文件 – 迴圈處理 .docx 資料夾中的檔案，對每個檔案套用相同的編輯與提取工作流程。

效能考量

使用 GroupDocs.Editor 時，請留意以下要點：

  • 資源管理 – 每處理完一個文件後呼叫 editor.close()，或讓 JVM 的垃圾回收機制釋放資源。
  • 批次處理 – 可順序處理或使用執行緒池，但需監控記憶體使用情況。
  • 載入選項調校 – 針對大型文件，調整 WordProcessingLoadOptions（例如停用不必要的功能）以提升效能。

常見問題

Q: GroupDocs.Editor 是否相容所有 Java 版本？
A: 是的，支援 JDK 8 以及更新版本。

Q: 我可以編輯受密碼保護的文件嗎？
A: 當然可以。只需透過 WordProcessingLoadOptions 提供密碼即可。

Q: 提取資源對我的工作流程有何好處？
A: 可集中管理資產、簡化品牌更新，並在不同平台間重複使用。

Q: 批次處理的效能影響為何？
A: 透過適當的資源清理與最佳化載入選項，即使處理數十個檔案也能保持低記憶體使用。

Q: GroupDocs.Editor 能與雲端儲存服務整合嗎？
A: 能，您可以直接從 AWS S3、Azure Blob 或 Google Cloud Storage 串流檔案至 Editor。

資源

遵循本指南後，您已具備使用 GroupDocs.Editor for Java 編輯 docx 檔案並提取所有相關資源的堅實基礎。歡迎嘗試額外的 API 功能，例如拼寫檢查、變更追蹤或自訂 HTML 轉換，進一步擴充您的解決方案。

最後更新： 2026-03-22
測試環境： GroupDocs.Editor 25.3 for Java
作者： GroupDocs