Java 实现 Word 文档内容复制：段落、章节与全文合并技巧

在处理 Word 文档时，开发人员常遇到需要将一份文档中的部分内容（如特定段落、表格）或全部内容合并到另一份文档的场景。由于 .docx 格式本质上是包含 XML、样式和资源的压缩包，直接进行文本拼接会破坏格式。

本文介绍一种基于 Java 的解决方案，通过编程方式在不安装 Microsoft Office 的前提下，完成 Word 文档内容的精确复制。我们将依次演示复制指定段落、复制整个“节”以及合并完整文档的三种实现方式。

1. 项目依赖配置

本次实现基于一个处理 Word 文档的 Java 库。如果你使用 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>14.6.0</version>
    </dependency>
</dependencies>

对于非 Maven 项目，可以手动获取 JAR 文件并将其添加到项目的构建路径中。需要注意，该产品存在免费版本，但免费版本对处理能力有一定限制（例如最多处理 500 个段落），在处理较大文档时需留意这一约束。

2. 复制指定的段落

某些业务场景下，我们只需要提取源文档中的某几段文字（如合同条款、法律声明）插入到目标文档中。可以通过 deepClone() 方法实现段落对象的深拷贝，该方法能够完整保留段落内的文本格式、图片及特殊符号。

操作步骤：

1. 分别加载源文档和目标文档实例。
2. 通过索引获取源文档中特定的段落对象。
3. 调用 deepClone() 克隆这些段落，并将其添加到目标文档的指定章节末尾。
4. 保存修改后的目标文档。

import com.spire.doc.Document;
import com.spire.doc.FileFormat;
import com.spire.doc.Section;
import com.spire.doc.documents.Paragraph;

public class CopyParagraphs {
    public static void main(String[] args) {
        // 加载源文档
        Document sourceDoc = new Document();
        sourceDoc.loadFromFile("source.docx");

        // 加载目标文档
        Document targetDoc = new Document();
        targetDoc.loadFromFile("target.docx");

        // 获取源文档的第一个章节，并取出第 3 段和第 4 段（索引从 0 开始）
        Section sourceSection = sourceDoc.getSections().get(0);
        Paragraph p1 = sourceSection.getParagraphs().get(2);
        Paragraph p2 = sourceSection.getParagraphs().get(3);

        // 获取目标文档的最后一个章节用于追加
        Section lastSection = targetDoc.getLastSection();

        // 克隆并添加段落
        lastSection.getParagraphs().add(p1.deepClone());
        lastSection.getParagraphs().add(p2.deepClone());

        // 保存结果
        targetDoc.saveToFile("CopyParagraphs.docx", FileFormat.Docx_2019);

        sourceDoc.dispose();
        targetDoc.dispose();
    }
}

3. 复制整个“节”的内容

Word 文档由若干“节”（Section）构成，每个节可以拥有独立的页眉、页脚、页面边距和纸张方向。当我们需要完整保留源文档的版面布局时，复制整个节是更合适的选择。

需要注意的是，不能简单地将 Section 对象直接添加到目标文档中，否则可能导致样式冲突或内容错位。正确的做法是遍历源节正文中的所有子对象（段落、表格、图形等），逐一克隆后添加到目标节的正文集合中。

import com.spire.doc.Document;
import com.spire.doc.DocumentObject;
import com.spire.doc.FileFormat;
import com.spire.doc.Section;

public class CopySection {
    public static void main(String[] args) {
        Document sourceDoc = new Document();
        sourceDoc.loadFromFile("source.docx");

        Document targetDoc = new Document();
        targetDoc.loadFromFile("target.docx");

        // 获取源文档的第一个节
        Section sourceSection = sourceDoc.getSections().get(0);
        // 获取目标文档的最后一个节
        Section targetSection = targetDoc.getLastSection();

        // 遍历源节中的所有文档元素
        for (int i = 0; i < sourceSection.getBody().getChildObjects().getCount(); i++) {
            DocumentObject obj = sourceSection.getBody().getChildObjects().get(i);
            targetSection.getBody().getChildObjects().add(obj.deepClone());
        }

        targetDoc.saveToFile("CopySection.docx", FileFormat.Docx_2019);
        
        sourceDoc.dispose();
        targetDoc.dispose();
    }
}

4. 复制整个文档（文档合并）

如果需要将一个文档的完整内容追加到另一个文档的末尾，可以使用 insertTextFromFile 方法。这是一种较为简便的合并方式，适用于不需要精细控制插入位置的场景。

import com.spire.doc.Document;
import com.spire.doc.FileFormat;

public class MergeDocuments {
    public static void main(String[] args) {
        Document targetDoc = new Document();
        targetDoc.loadFromFile("target.docx");

        // 将源文档内容插入到目标文档末尾
        targetDoc.insertTextFromFile("source.docx", FileFormat.Docx);

        targetDoc.saveToFile("MergedDocument.docx", FileFormat.Docx_2019);
        
        targetDoc.dispose();
    }
}

该方法默认会在插入内容前添加一个分节符或分页符。如果需要实现完全无缝的拼接（例如不产生额外分页），建议采用前述“复制节”中的遍历方式手动控制。

5. 页眉、页脚与水印的处理

上述示例主要针对文档正文内容。如果需要复制页眉、页脚或水印，需要单独编写处理逻辑。

• 页眉页脚：可以通过 Section.getHeadersFooters() 获取页眉页脚集合，然后遍历其中的元素进行克隆和添加。
• 水印：部分工具提供了相对简便的水印复制方式，可以直接将源文档的水印对象应用到目标文档。

// 水印复制示例
Document sourceDoc = new Document("source.docx");
Document targetDoc = new Document("target.docx");

targetDoc.setWatermark(sourceDoc.getWatermark());
targetDoc.saveToFile("CopyWatermark.docx", FileFormat.Docx);

6. 常见问题与注意事项

关于评估提示：如果生成的文档顶部出现红色警告文本，通常是因为未加载许可证文件，当前运行在免费模式下。免费版虽然可以执行复制操作，但会产生评估水印并限制文档处理规模（通常限制为 500 个段落）。

关于样式丢失：当将源文档内容复制到一个全新的空白文档时，由于新文档可能不包含源文档中定义的某些自定义样式，复制后样式可能会发生变化。建议目标文档预先包含所需的基础样式，或者通过相关方法克隆默认样式。

关于复杂元素：使用 deepClone() 时，图片、表格、文本框等复杂元素会被完整保留，无需额外编写处理代码。这也是采用此类工具相比手动解析 XML 的主要便利之处。

总结

本文介绍了三种在不同粒度下使用 Java 复制 Word 文档内容的操作方式，分别对应段落级、章节级和全文级的复制需求。通过对象克隆机制，开发者可以在不深入了解 Office 底层 XML 结构的前提下，完成带有完整格式的内容搬运。在实际开发中，建议根据具体场景选择合适的方式：小范围内容复用采用段落复制，需要保留版面布局时采用节复制，简单的文档合并则可以直接使用文档插入方法。同时需要留意免费版本的处理能力限制，以及页眉页脚等特殊内容需要单独处理的情况。