使用 GroupDocs.Editor 編輯 Word 文件（Java）

在當今快速變化的商業環境中，能夠直接在 Java 程式碼中 編輯 Word 文件（Java） 可大幅減少人工工作並消除相容性問題。無論您需要更新季報、客製化合約範本，或產生個人化信件，程式化編輯都能提供點擊工具常缺乏的速度與可靠性。本指南將帶您了解如何案、以程式方式修改其內容，並將結果儲存為多種常見格式——全部使用 GroupDocs.Editor for Java。

快速解答

  • 什麼函式庫可以讓我在 Java 中編輯 Word 文件？ GroupDocs.Editor for Java.
  • 我可以自動取代文字嗎？ 可以 – 使用 HTML 標記 API 進行搜尋純文字等。
    -** 免費試用可用指將 .docx 檔案載入記憶體，透過 API 操作其內容（文字、圖片、表格等），然後將更新後的檔案寫回磁碟或使用 Group- 無需 Microsoft Office 相依 – 可在任何伺服器或容器上執行。
  • 高保真度 – 保留原始版面配置、樣式與嵌入物件。
  • 多種輸出格式 – 只需一次呼叫即可在 DOCX、DOCM、RTF、TXT 之間切換。
  • 可擴充 – 適用於大量文件的批次處理。

前置條件

  • Java 8 以上，並具備建置工具（Maven 或 Gradle）。
  • 取得 GroupDocs.Editor for Java 函式庫（版本 25.3 或更新）。
  • 具備 Java 與 Maven 相依管理的基本知識。

設定 GroupDocs.Editor for Java

透過 Maven 安裝

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

直接下載

Alternatively, download the latest JAR from the GroupDocs.Editor for Java 發行頁面.

取得授權

先使用免費試用版探索 API。若用於正式環境，請從 GroupDocs 入口網站取得臨時或完整授權。

基本初始化與設定

建立指向來源 DOCX 檔案的 Editor 實例：

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

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

現在您已準備好載入、編輯與儲存文件。

實作指南

載入文件

概覽： 載入後會取得可供操作的 EditableDocument 物件。

步驟 1：匯入必要套件

import com.groupdocs.editor.Editor;
import com.groupdocs.editor.EditableDocument;

步驟 2：使用您的文件初始化 Editor

String inputFilePath = "YOUR_DOCUMENT_DIRECTORY/sample.docx";
Editor editor = new Editor(inputFilePath, new WordProcessingLoadOptions());
EditableDocument defaultWordProcessingDoc = editor.edit();

編輯文件內容

概覽： 文件以 HTML 形式呈現，使文字取代變得簡單。

步驟 3：取得並修改嵌入的 HTML

String allEmbeddedInsideString = defaultWordProcessingDoc.getEmbeddedHtml();
String modifiedContent = allEmbeddedInsideString.replace("Subtitle", "Edited subtitle");

以 RTF 格式儲存文件

概覽： 編輯完成後，可匯出為 Rich Text Format（RTF）。

步驟 4：設定儲存選項

import com.groupdocs.editor.options.WordProcessingSaveOptions;
import com.groupdocs.editor.formats.WordProcessingFormats;

String outputRtfPath = "YOUR_OUTPUT_DIRECTORY/editedDoc.rtf";
WordProcessingSaveOptions rtfSaveOptions = new WordProcessingSaveOptions(WordProcessingFormats.Rtf);

步驟 5：儲存文件

EditableDocument editedDocRtf = EditableDocument.fromMarkup(modifiedContent, null);
editor.save(editedDocRtf, outputRtfPath, rtfSaveOptions);
editedDocRtf.dispose();
editor.dispose();

以串流方式儲存為 DOCM

概覽： 使用串流可更靈活地決定檔案儲存位置（例如雲端儲存）。

步驟 6：設定 DOCM 儲存選項

WordProcessingSaveOptions docmSaveOptions = new WordProcessingSaveOptions(WordProcessingFormats.Docm);

步驟 7：寫入串流

import java.io.ByteArrayOutputStream;
import java.io.OutputStream;

String outputDocmPath = "YOUR_OUTPUT_DIRECTORY/editedDoc.docm";
try (OutputStream outputStream = new ByteArrayOutputStream()) {
    editor.save(editedDocDocm, outputStream, docmSaveOptions);
}

以純文字格式儲存文件

概覽： 匯出為純文字有助於內容索引或簡易資料抽取。

步驟 8：設定文字儲存選項

import com.groupdocs.editor.options.TextSaveOptions;
import java.nio.charset.StandardCharsets;

TextSaveOptions textSaveOptions = new TextSaveOptions();
textSaveOptions.setEncoding(StandardCharsets.UTF_8);
textSaveOptions.setPreserveTableLayout(true);

步驟 9：儲存為純文字

String outputTxtPath = "YOUR_OUTPUT_DIRECTORY/editedDoc.txt";
editor.save(editedDocTxt, outputTxtPath, textSaveOptions);

實務應用

  1. 自動化報告產生 – 從資料庫提取資料，取代佔位符，輸出精美的 DOCX 或 RTF 報告。
  2. 範本客製化 – 根據使用者輸入動態填寫行銷或法律範本。
  3. 文件翻譯工作流程 –留格式。

效能考量

  • 在完成後盡快檔案大型文件記憶體不足錯誤** | 增加 JVM 堆積大小（-Xmx）或在編輯前將文件拆分為較小的部分。 | | 取代後格式遺失 | 謹慎使用 HTML 標記 API；避免直接取代標記標籤本身。 | | 授權未套用 | 在建立 Editor 前呼叫 License license = new License(); license.setLicense("path/to/license.file");。 |

常見問答

Q: 我可以編輯受密碼保護的 Word 檔案嗎？
A: 可以。使用包含密碼的 WordProcessingLoadOptions 載入文件，然後照常操作。

Q: GroupDocs.Editor 支援 DOCM 檔案中的巨集嗎？
A: 函式庫會保留巨集但不執行它們。您可以將包含巨集的 DOCM 檔案保存而不變更。

Q: 我該如何處理文件中嵌入的圖片？
A: 圖片作為 HTML 標記的一部分保留。您可以替換 <img> 標籤或使用標準 HTML 新增圖片。

Q: 能直接轉換為 PDF 嗎？
A: GroupDocs.Editor 主要用於編輯；若需 PDF 轉換，可在保存編輯後的 DOCX 後，結合 GroupDocs.Conversion 使用。

Q: 支援哪些 Java 版本？
A: 完全支援 Java 8 及以上版本。

結論

現在您已掌握使用 GroupDocs.Editor 進行 編輯 Word 文件（Java） 的完整端對端工作流程。透過載入 DOCX、以程式方式修改其 HTML，並匯出為 RTF、DOCM 或純文字等格式，您可以在 Java 應用程式中自動化無數以文件為中心的任務。探索其他功能，如拼寫檢查、變更追蹤，或與 GroupDocs.Conversion 整合，以進一步擴充您的解決方案。

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