Java 操作 Word：插入分页符与分节符

在 Java 后端开发中，动态生成 Word 文档时，经常需要在特定位置开启新的一页，或者在同一个文档里混合使用纵向和横向页面。这些需求，本质上是在 Word 文档中插入分页符和分节符。

本文记录如何使用 Spire.Doc for Java 库，通过 Java 代码实现这两个操作。内容包括环境配置、API 用法和可直接运行的代码示例。

一、环境配置

Spire.Doc for Java 是一个用于操作 Word 文档的库，不依赖服务器安装 Office。使用 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.4.9</version>
    </dependency>
</dependencies>

不使用 Maven 的项目，可以下载 JAR 包手动导入。

二、分页符与分节符的区别

两者的功能差异如下：

简单来说：分页符只改变内容的起始位置；分节符改变文档的逻辑结构。

三、插入分页符

3.1 在段落末尾插入

这是常用场景：某个段落结束后，希望后续内容移至新的一页。

核心方法：Paragraph.appendBreak(BreakType.Page_Break)

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

public class PageBreakDemo {
    public static void main(String[] args) {
        Document doc = new Document();
        doc.loadFromFile("input.docx");

        Section section = doc.getSections().get(0);
        Paragraph para = section.getParagraphs().get(2); // 第 3 个段落

        para.appendBreak(BreakType.Page_Break);

        doc.saveToFile("output_page_break.docx", FileFormat.Auto);
    }
}

3.2 在特定文字后插入

若需在段落中间某处换页（如“第一章”之后），需先定位到 TextRange。

import com.spire.doc.*;
import com.spire.doc.documents.BreakType;
import com.spire.doc.documents.Paragraph;
import com.spire.doc.documents.TextSelection;
import com.spire.doc.fields.TextRange;

public class PageBreakAtTextDemo {
    public static void main(String[] args) {
        Document doc = new Document();
        doc.loadFromFile("input.docx");

        TextSelection selection = doc.findString("第二章 技术架构", false, true);

        if (selection != null) {
            TextRange range = selection.getAsOneRange();
            Paragraph para = range.getOwnerParagraph();
            int position = para.getChildObjects().indexOf(range);

            Break pageBreak = new Break(doc, BreakType.Page_Break);
            para.getChildObjects().insert(position + 1, pageBreak);
        }

        doc.saveToFile("output_page_break_at_text.docx", FileFormat.Auto);
    }
}

四、插入分节符

分节符允许在同一文档中应用不同的页面设置。插入方法为 Paragraph.insertSectionBreak(SectionBreakType)，支持以下类型：

• New_Page：下一页分节符
• No_Break：连续分节符（不换页）
• Odd_Page：奇数页分节符
• Even_Page：偶数页分节符

示例：插入“下一页”分节符

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

public class SectionBreakDemo {
    public static void main(String[] args) {
        Document doc = new Document();
        doc.loadFromFile("input.docx");

        Section section = doc.getSections().get(0);
        Paragraph para = section.getParagraphs().get(5); // 第 6 个段落

        para.insertSectionBreak(SectionBreakType.New_Page);

        doc.saveToFile("output_section_break.docx", FileFormat.Auto);
    }
}

执行后，文档在该段落位置分节，新节从下一页开始。

五、利用分节符设置独立页眉页码

分节后，各节属性可独立控制。以下代码演示为第二节设置不同的页眉，并让页码从 1 开始重新编号：

// 假设已插入分节符，doc 现有两个节

Section secondSection = doc.getSections().get(1);

// 清除第二节默认页眉，断开与第一节的链接
secondSection.getHeadersFooters().getHeader().getChildObjects().clear();
secondSection.getHeadersFooters().getFooter().getChildObjects().clear();

// 添加新页眉文本
Paragraph headerPara = secondSection.getHeadersFooters().getHeader().addParagraph();
headerPara.setText("第二章专用页眉");

// 页码从 1 开始重新编号
secondSection.getPageSetup().setRestartPageNumbering(true);
secondSection.getPageSetup().setPageStartingNumber(1);

doc.saveToFile("output_different_header.docx", FileFormat.Auto);

六、注意事项

1. 分页符的可见性：在 Word 中打开生成的文件，默认不显示分页符符号，需开启“显示/隐藏编辑标记”才能看到，但不影响实际效果。

2. 空段落可插入分节符：若目标段落为空，插入操作依然有效。

3. 分节符不能插入表格内部：需先退出表格再操作。

4. 大文档性能：文档超过 200 页且频繁插入分节符时，可先关闭字段自动更新（setUpdateFields(false)），操作完成后再重新开启并更新。

七、总结

本文介绍了使用 Spire.Doc for Java 在 Word 文档中插入分页符和分节符的方法。分页符用于实现简单的换页操作，不改变文档的节结构；分节符则将文档划分为逻辑上独立的区块，使得同一文档内可以并存多种页面方向、页眉页脚内容和页码格式。掌握这两种元素的插入方法后，可以应对企业级报告、合同生成、标书制作等场景中的常见排版需求。实际使用时，根据业务规则选择合适的插入位置和类型，上线前进行充分的格式验证即可。