在日常辦公和軟件開發中，我們經常會遇到需要將多個 Word 文檔合併成一個的需求。無論是整合項目報告、生成批量合同，還是彙編用户手冊，手動操作不僅效率低下，還極易出錯。幸運的是，藉助 Java 編程，我們可以輕鬆實現 Word 文檔的自動化合並。本文將聚焦於 Spire.Doc for Java 這一功能強大的庫，為您提供詳細的教程和實用的代碼示例，幫助您在 Java 應用中高效地合併 Word 文檔。

認識 Spire.Doc for Java 並進行環境搭建

Spire.Doc for Java 是一個專業的、獨立的 Java Word API，專門用於創建、讀取、寫入、轉換和打印 Word 文檔。它支持 DOC、DOCX、RTF、XML、TXT、ODT 等多種 Word 文件格式。其核心優勢在於無需安裝 Microsoft Office，即可在 Java 應用程序中進行各種複雜的 Word 文檔操作，包括文本、圖片、表格、段落、樣式、頁眉頁腳的管理，以及文檔合併、拆分等高級功能。憑藉其豐富的功能和易於使用的 API 設計，Spire.Doc for Java 成為 Java 文檔處理領域的得力工具。

依賴引入與環境配置

要開始使用 Spire.Doc for Java，您需要將其庫文件引入到您的 Java 項目中。最常見和推薦的方式是通過 Maven 或 Gradle 進行依賴管理。

Maven 依賴配置：

在您的 pom.xml 文件中，添加以下依賴項：

<repositories>
    <repository>
        <id>com.e-iceblue</id>
        <name>e-iceblue</name>
        <url>https://repo.e-iceblue.cn/repository/maven-public/</url>
    </repository>
</repositories>
<dependencies>
    <dependency>
        <groupId>e-iceblue</groupId>
        <artifactId>spire.doc</artifactId>
        <version>13.12.2</version>
    </dependency>
</dependencies>

提示: 上述版本號 5.2.0 可能會有更新，請訪問 Spire.Doc for Java 官方網站或 Maven 倉庫查看最新版本。免費版 (spire.doc.free) 僅支持部分功能，若需完整功能，請考慮購買商業授權版。

方法一：通過插入文件的方式合併 Word 文檔

這種合併方式適用於將一個或多個 Word 文檔的內容，完整地插入到另一個 Word 文檔的特定位置。例如，您有一個主報告模板，需要將各個團隊提交的子報告作為獨立的章節插入其中。其基本原理是加載主文檔，然後將其他文檔作為文件內容插入到主文檔的指定位置。

詳細步驟與代碼示例

以下是將示例2.docx 的內容插入到示例1.docx 末尾的示例：

1. 加載主文檔： 使用 Document 類加載作為合併目標的主 Word 文檔。
2. 加載待插入文檔： 同樣使用 Document 類加載需要插入的 Word 文檔。
3. 指定插入位置並執行插入： Spire.Doc for Java 提供了 Document.insertTextFromFile() 方法，可以將一個 Word 文檔的內容插入到另一個文檔的指定位置。您可以指定插入的文本內容、插入模式和格式。在這裏，我們選擇將整個文檔插入到主文檔的末尾。
4. 保存結果： 將合併後的文檔保存為新的 Word 文件。

import com.spire.doc.*;

public class merge {
    public static void main(String[] args) {
        //創建 Document 類的對象並從磁盤加載 Word 文檔
        Document document = new Document("C:/示例/示例1.docx");

        //將另一個文檔插入當前文檔
        document.insertTextFromFile("C:/示例/示例2.docx", FileFormat.Docx_2013);

        //保存結果文檔
        document.saveToFile("合併結果.docx", FileFormat.Docx_2013);
    }
}

方法二：通過克隆（追加）的方式合併 Word 文檔

這種合併方式是最常用和推薦的文檔合併策略，適用於將多個獨立的 Word 文檔的內容按順序追加到一個新的或現有文檔中，形成一個連續的整體。例如，您有多個獨立的章節文件，需要按順序組合成一本完整的書籍。其基本原理是創建一個新的（或加載一個目標）文檔，然後將其他源文檔的各個部分（通常是 Section 或 Body 的內容）克隆並追加到目標文檔中。

詳細步驟與代碼示例

以下是將 doc1.docx 和 doc2.docx 的內容追加到一個新文檔 merged_by_append.docx 中的示例：

1. 創建新文檔（或加載目標文檔）： 創建一個空的 Document 對象作為合併結果的載體。
2. 加載源文檔： 逐一加載需要合併的 Word 文檔。
3. 追加文檔內容： 使用 deepClone() 方法將源文檔的內容追加到目標文檔的末尾。這個方法會自動處理頁眉頁腳、樣式等，確保內容無縫連接。
4. 保存結果： 將合併後的文檔保存為新的 Word 文件。

import com.spire.doc.*;

public class mergeDocuments {
    public static void main(String[] args){
        //創建兩個 Document 類的對象頂分別載入 Word 文檔
        Document document1 = new Document("C:/Users/Allen/Desktop/示例1.docx");
        Document document2 = new Document("C:/Users/Allen/Desktop/示例2.docx");

        //在第二個文檔中循環獲取所有節
        for (Object sectionObj : (Iterable) document2.getSections()) {
            Section sec=(Section)sectionObj;
            //在所有節中循環獲取所有子對象
            for (Object docObj :(Iterable ) sec.getBody().getChildObjects()) {
                DocumentObject obj=(DocumentObject)docObj;

                //獲取第一個文檔的最後一節
                Section lastSection = document1.getLastSection();

                //將所有子對象添加到第一個文檔的最後一節中
                Body body = lastSection.getBody();
                body.getChildObjects().add(obj.deepClone());
            }
        }

        //保存結果文檔
        document1.saveToFile("MergingResult.docx", FileFormat.Docx_2013);
    }
}

提示: deepClone() 是一個非常方便的方法，它可以將整個文檔追加到另一個文檔的末尾，並自動處理格式。

結論

本文詳細介紹瞭如何使用 Spire.Doc for Java 庫在 Java 中實現 Word 文檔的合併。我們探討了兩種主要的合併策略：通過插入文件的方式（通過逐節克隆實現內容插入）和通過克隆追加的方式。第一種方法適用於將內容整合到現有文檔的特定位置，而第二種方法則更適合將多個文檔按順序組合成一個全新的文檔。

Spire.Doc for Java 以其強大的功能和易用性，極大地簡化了 Java 應用程序中的 Word 文檔處理任務。通過本文提供的代碼示例和詳細步驟，您應該能夠輕鬆地在自己的項目中實現 Word 文檔的自動化合並。現在，是時候將這些技術運用到您的實際項目中，提升工作效率，並探索更多文檔處理的無限可能性了！您還可以嘗試合併不同格式的文檔，或者在合併過程中進行內容的修改和格式的調整，Spire.Doc for Java 都將為您提供強大的支持。