從 DOCX 產生 HTML（使用 GroupDocs.Editor Java）

在現代企業應用程式中，從 DOCX 產生 HTML 是發布報告、合約或任何基於 Word 的內容到網路上的常見需求。本教學將帶您一步步載入 DOCX 檔案、以程式方式編輯，並提取樣式化產生 HTML 所需的 CSS——全部使用 GroupDocs.Editor for Java。完成後，您將擁有可直接放入任何 Java 後端的生產就緒程式碼片段。

快速解答

  • GroupDocs.Editor 的功能是什麼？ 它在 Java 中載入、編輯並提取內容（包括 CSS），支援 Word、Excel、PowerPoint 以及其他格式。
  • 如何載入 DOCX 檔案？ 使用 Editor 搭配 WordProcessingLoadOptions（請參閱「載入 Word 文件」章節）。
  • 載入後我可以編輯文件嗎？ 可以——透過 editor.edit(editOptions) 取得 EditableDocument。
  • 如何提取 CSS？ 呼叫 editableDocument.getCssContent(imagePrefix, fontPrefix) 取得樣式表。
  • 是否需要授權？ 提供免費試用或臨時授權；正式環境需購買完整授權。

什麼是「edit word document java」？

直接在 Java 程式碼中編輯 Word 文件，可讓您替換佔位符、更新表格或重新設定樣式，無需手動操作。GroupDocs.Editor 抽象化了複雜的 OpenXML 處理，提供簡單的高階 API，能在任何 Java 應用程式中呼叫，無論是 Web 服務、批次工作或桌面工具。

為什麼要在 Java 中使用 GroupDocs.Editor？

GroupDocs.Editor 支援 20+ 種輸入與輸出格式——包括 DOC、DOCX、ODT 以及 HTML，且可處理高達 500 MB 的檔案而無需將整個檔案載入記憶體。它可在任何伺服器端環境執行，免除安裝 Microsoft Office 的需求，並內建 CSS 提取功能，方便與網站整合。

前置條件

  • GroupDocs.Editor 程式庫（Maven 或手動下載）。
  • JDK 8+ 已安裝並設定。
  • 如 IntelliJ IDEA、Eclipse 或 NetBeans 等 IDE，方便除錯。

設定 GroupDocs.Editor for Java

Maven 設定

pom.xml 檔案宣告 GroupDocs.Editor 的 Maven 相依性。

pom.xml 是標準的 Maven 專案描述檔，列出所有必要的函式庫。

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

直接下載

或者，從官方網站下載最新的 JAR 檔案：GroupDocs.Editor for Java releases。

取得授權

  • 免費試用 – 立即開始使用。
  • 臨時授權 – 申請延長評估期。
  • 完整授權 – 購買後可無限制於正式環境使用。

基本初始化

Editor 類別是載入與操作文件的入口點。以下程式碼示範如何以範例文件路徑建立 Editor 類別的實例：

Editor 物件負責文件的載入、編輯與轉換流程。

import com.groupdocs.editor.Editor;

public class InitializeGroupDocsEditor {
    public static void main(String[] args) throws Exception {
        // Example path to your document directory
        String filePath = "YOUR_DOCUMENT_DIRECTORY/sample.docx";
        
        Editor editor = new Editor(filePath);
        System.out.println("GroupDocs.Editor initialized successfully!");
    }
}

如何在 Java 中從 DOCX 產生 HTML？

從 DOCX 檔案產生 HTML 需要三個主要步驟：使用適當的選項載入文件、（可選）編輯內容，然後呼叫 HTML 轉換 API。首先，建立 Editor 實例並使用 WordProcessingLoadOptions 載入檔案。接著呼叫 editor.edit(editOptions) 取得 EditableDocument。最後，透過 editableDocument.getHtml() 取得 HTML 字串，並使用 editableDocument.getCssContent() 取得相應的 CSS。此工作流程會產生符合標準的乾淨 HTML，可直接嵌入網頁或進一步處理。

如何在 Java 中載入 docx？

載入 DOCX 檔案是進行任何編輯或 CSS 提取之前的第一步。首先匯入必要的 GroupDocs.Editor 類別，然後設定 WordProcessingLoadOptions 以指定密碼處理、編碼及其他載入時設定。建立帶有檔案路徑與載入選項的 Editor 實例，最後呼叫 editor.load() 取得代表已載入文件的 DocumentInfo 物件。此物件提供中繼資料，並為後續的編輯或轉換作業做準備。

載入 Word 文件

概述 – 本節示範如何使用 GroupDocs.Editor 載入 Word 文件。

步驟 1：匯入必要的類別

以下的 import 陳述式會將所需的 GroupDocs.Editor 類別匯入範圍。

import com.groupdocs.editor.Editor;
import com.groupdocs.editor.options.WordProcessingLoadOptions;

步驟 2：初始化載入選項

WordProcessingLoadOptions 指定 DOCX 檔案的載入方式，包括密碼處理與編碼。

WordProcessingLoadOptions loadOptions = new WordProcessingLoadOptions();

步驟 3：建立 Editor 實例並載入文件

Editor 是載入、編輯與轉換文件的主要入口。它接受檔案路徑與載入選項，然後 load() 會回傳 DocumentInfo 物件。

String documentPath = "YOUR_DOCUMENT_DIRECTORY/sample.docx";
Editor editor = new Editor(documentPath, loadOptions);
System.out.println("Document loaded successfully!");

如何在 Java 中編輯 Word 文件？

文件載入後，即可修改內容、替換佔位符或調整格式。編輯是在 EditableDocument 實例上執行，該實例提供文字替換、表格操作與樣式變更的方法。完成修改後，可將文件儲存回 DOCX，或轉換為其他格式，如 HTML 或 PDF。

編輯 Word 文件

概述 – 編輯是在 EditableDocument 實例上執行。

步驟 1：匯入編輯類別

這些 import 讓您可以存取 EditableDocument、EditOptions 以及相關輔助類別。

import com.groupdocs.editor.EditableDocument;
import com.groupdocs.editor.options.WordProcessingEditOptions;

步驟 2：初始化編輯選項

EditOptions 讓您控制輸出為 HTML、PDF 或保留原始格式，亦可定義渲染設定。

WordProcessingEditOptions editOptions = new WordProcessingEditOptions();

步驟 3：載入文件以進行編輯

呼叫 editor.edit(editOptions) 會回傳可程式化操作的 EditableDocument。

EditableDocument editableDocument = editor.edit(editOptions);
System.out.println("Document ready for editing!");

如何使用前置詞提取 CSS 內容？

提取 CSS 可讓您在 Web 應用程式或自訂 HTML 報告中重複使用文件的樣式。首先，匯入負責 CSS 提取的類別，然後定義將會加在圖片與字型參考前的 URL 前置詞。最後，呼叫 editableDocument.getCssContent(imagePrefix, fontPrefix) 取得包含所有 CSS 規則的字串，可直接嵌入或與產生的 HTML 一起儲存。

使用前置詞提取 CSS 內容

概述 – 定義外部資源前置詞並取得樣式表。

步驟 1：匯入必要的類別

這些類別提供 CSS 提取與圖片處理的方法。

import com.groupdocs.editor.EditableDocument;
import java.util.List;

步驟 2：定義外部前置詞

imagePrefix 與 fontPrefix 為 URL 片段，會加在產生的 CSS 中圖片與字型的參考前。

String externalImagesPrefix = "http://www.mywebsite.com/images/id=";
String externalFontsPrefix = "http://www.mywebsite.com/fonts/id=";

步驟 3：提取 CSS 內容

editableDocument.getCssContent(imagePrefix, fontPrefix) 會回傳包含所有 CSS 規則的字串，可直接嵌入或儲存。

List<String> stylesheets = editableDocument.getCssContent(externalImagesPrefix, externalFontsPrefix);
System.out.println("CSS content extracted successfully!");

實務應用

  • 自動化報告 – 從 Word 範本產生具樣式的 HTML 報告。
  • 網站內容整合 – 將 Word 產生的 CSS 嵌入網頁，以維持一致的品牌形象。
  • 批次文件樣式化 – 自動將公司全域樣式指南套用至數千份現有文件。

效能考量

  • 資源管理 – 使用完畢後關閉串流並釋放 Editor 實例，以釋放記憶體。
  • 大型檔案 – 對於非常大的 DOCX 檔案，考慮分塊處理或使用串流 API。
  • 垃圾回收 – 若發現記憶體使用量高，請調整 JVM 堆積設定。

結論

現在您已掌握完整的端對端範例，說明如何透過 GroupDocs.Editor 載入 DOCX、進行編輯並提取 CSS，以 從 DOCX 產生 HTML。這些技巧為任何基於 Java 的後端提供強大的文件自動化應用場景。

下一步

  • 嘗試不同的 WordProcessingLoadOptions（例如受密碼保護的檔案）。
  • 探索其他 API，如 editableDocument.getHtml() 以完成完整的 HTML 轉換。
  • 將提取的 CSS 整合至您的 Web 前端，以維持視覺一致性。

欲取得更深入的參考資料，請造訪官方文件：GroupDocs documentation，並加入社群討論於 support forum。

常見問題

Q: GroupDocs.Editor 是否相容舊版 .doc 檔案？
A: 是的，它同時支援舊版 .doc 與現代 .docx 格式。

Q: 處理大量大型文件時，如何提升效能？
A: 盡可能重複使用單一 Editor 實例，及時關閉串流，並考慮增大 JVM 堆積大小。

Q: 我能同時提取圖片與 CSS 嗎？
A: 可以——使用 EditableDocument 的 getImages() 方法取得嵌入的圖片。

Q: SaaS 產品應選擇哪種授權模式？
A: GroupDocs 同時提供每位開發者授權與伺服器授權，請聯絡業務以取得客製化方案。

Q: 此函式庫能在 Linux 容器上運作嗎？
A: 當然可以——只要 JRE 可用，GroupDocs.Editor 即與平台無關。

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

相關教學