在Word 中插入页眉页脚：实用 Java 指南

在现代企业应用中，Java 开发者经常需要处理各种文档操作，其中对 Word 文档的自动化处理尤为常见。无论是生成报告、合同还是其他商业文档，页眉页脚作为文档结构的重要组成部分，承载着公司 Logo、页码、版权信息等关键内容。手动添加效率低下且容易出错，因此，如何通过编程方式高效、灵活地在 Word 文档中插入页眉页脚，成为了许多开发者面临的实际痛点。本文将深入探讨如何利用功能强大的 Spire.Doc for Java 库，为您的 Word 文档轻松实现各种页眉页脚的插入需求。

Spire.Doc for Java 库优势介绍与安装

Spire.Doc for Java 是一个专业的 Word Java API，它允许开发者在 Java 应用程序中创建、读取、写入、转换和打印 Word 文档，而无需安装 Microsoft Word。其在处理页眉页脚方面提供了丰富且直观的 API，无论是简单的文本页眉页脚，还是复杂的图片、页码、奇偶页不同设置，都能轻松应对。

Maven 依赖配置：

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.8.7</version>
    </dependency>
</dependencies>

Java 为 Word 文档添加通用页眉页脚

为 Word 文档的每个页面添加统一的页眉和页脚是最常见的需求。这通常包括公司名称、文档标题、页码、Logo 等。以下代码演示了如何加载一个文档（或新建文档），设置其页眉和页脚内容，并保存。

scss 复制代码

import com.spire.doc.*;
import com.spire.doc.documents.*;
import com.spire.doc.fields.DocPicture;
import com.spire.doc.fields.Field;
import com.spire.doc.fields.TextRange;

import java.awt.*;

public class insertHeaderAndFooter {

    public static void main(String[] args) {

        //创建 Document 类的对象
        Document document = new Document();

        //载入Word文档
        document.loadFromFile("人类：交织的生命.docx");

        //获取文档第一节
        Section section = document.getSections().get(0);

        //调用自定义方法 insertHeaderAndFooter() 来插入页眉和页脚
        insertHeaderAndFooter(section);

        //保存文档
        document.saveToFile("页眉和页脚.docx", FileFormat.Docx);
    }

    private static void insertHeaderAndFooter(Section section) {



        //从一个节获取页眉和页脚
        HeaderFooter header = section.getHeadersFooters().getHeader();
        HeaderFooter footer = section.getHeadersFooters().getFooter();

        //在页眉中添加一个段落
        Paragraph headerParagraph = header.addParagraph();

        //添加文本到页眉段落
        TextRange text = headerParagraph.appendText("哲学\r人类：交织的生命");
        text.getCharacterFormat().setFontName("微软雅黑");
        text.getCharacterFormat().setFontSize(10);
        text.getCharacterFormat().setItalic(true);
        headerParagraph.getFormat().setHorizontalAlignment(HorizontalAlignment.Center);

        //设置页眉段落的底部线条样式
        headerParagraph.getFormat().getBorders().getBottom().setBorderType(BorderStyle.Single);
        headerParagraph.getFormat().getBorders().getBottom().setLineWidth(1f);

        //在页脚中添加一个段落
        Paragraph footerParagraph = footer.addParagraph();

        //添加 Field_Page 和 Field_Num_Pages 域到页脚段落
        footerParagraph.appendField("页码", FieldType.Field_Page);
        footerParagraph.appendText(" / ");
        footerParagraph.appendField("页数", FieldType.Field_Num_Pages);
        footerParagraph.getFormat().setHorizontalAlignment(HorizontalAlignment.Center);

        //设置页脚段落的顶部线条样式
        footerParagraph.getFormat().getBorders().getTop().setBorderType(BorderStyle.Single);
        footerParagraph.getFormat().getBorders().getTop().setLineWidth(1f);
    }
}

页眉/页脚类型	API 调用方式	示例
文本	Paragraph.appendText()	headerParagraph.appendText("Hello World");
图片	Paragraph.appendPicture()	headerParagraph.appendPicture("path/to/image.png");
页码	Paragraph.appendField(fieldName, FieldType)	footerParagraph.appendField("page number", FieldType.Field_Page);

Java 实现 Word 文档首页面独立页眉页脚

有时，我们希望文档的第一页拥有一个独特的页眉页脚（例如，封面页可能只显示 Logo，而不显示页码），而后续页面则使用常规的页眉页脚。Spire.Doc 提供 DifferentFirstPage 属性来实现此功能。

scss 复制代码

import com.spire.doc.*;
import com.spire.doc.documents.*;
import com.spire.doc.fields.DocPicture;
import com.spire.doc.fields.TextRange;

import java.awt.*;

public class insertHeaderAndFooter {

    public static void main(String[] args) {

        //创建 Document 类的对象
        Document document = new Document();

        //载入Word文档
        document.loadFromFile("人类：交织的生命.docx");

        //获取文档第一节
        Section section = document.getSections().get(0);

        //设置文档第一页的页眉和页脚与其他页不同
        section.getPageSetup().setDifferentFirstPageHeaderFooter(true);

        //调用自定义的 insertHeaderAndFooterFirst() 方法来插入页眉和页脚到第一页
        insertHeaderAndFooterFirst(section);

        //保存文档
        document.saveToFile("第一页页眉和页脚.docx", FileFormat.Docx);
    }

    private static void insertHeaderAndFooterFirst(Section section) {

        //获取文档第一页的页眉和页脚
        HeaderFooter header = section.getHeadersFooters().getFirstPageHeader();
        HeaderFooter footer = section.getHeadersFooters().getFirstPageFooter();

        //添加一个段落到页眉
        Paragraph headerParagraph = header.addParagraph();

        //添加文本到页眉段落
        TextRange text = headerParagraph.appendText("哲学");
        text.getCharacterFormat().setFontName("微软雅黑");
        text.getCharacterFormat().setFontSize(14);
        text.getCharacterFormat().setTextColor(Color.blue);
        text.getCharacterFormat().setItalic(true);
        headerParagraph.getFormat().setHorizontalAlignment(HorizontalAlignment.Right);

        //插入一张图片到页眉段落并设置其位置
        DocPicture headerPicture = headerParagraph.appendPicture("页眉.png");
        headerPicture.setHorizontalAlignment(ShapeHorizontalAlignment.Left);
        headerPicture.setVerticalAlignment(ShapeVerticalAlignment.Top);

        //设置页眉段落的底部线条样式
        headerParagraph.getFormat().getBorders().getBottom().setBorderType(BorderStyle.Single);
        headerParagraph.getFormat().getBorders().getBottom().setLineWidth(1f);

        //将图片的文本环绕方式设置为衬于图片下方
        headerPicture.setTextWrappingStyle(TextWrappingStyle.Behind);

        //添加一个段落到页脚
        Paragraph footerParagraph = footer.addParagraph();

        //添加文本到页脚段落
        TextRange text1 = footerParagraph.appendText("人类：交织的生命");
        text1.getCharacterFormat().setFontName("微软雅黑");
        text1.getCharacterFormat().setFontSize(14);
        text1.getCharacterFormat().setTextColor(Color.blue);
        text1.getCharacterFormat().setItalic(true);
        footerParagraph.getFormat().setHorizontalAlignment(HorizontalAlignment.Center);

        //设置页脚段落的顶部线条样式
        footerParagraph.getFormat().getBorders().getTop().setBorderType(BorderStyle.Single);
        footerParagraph.getFormat().getBorders().getTop().setLineWidth(1f);
    }
}

Java 编程实现 Word 文档奇偶页不同页眉页脚

对于书籍、报告等需要专业排版的文档，通常会要求奇数页和偶数页的页眉页脚内容有所不同（例如，奇数页显示章节标题，偶数页显示文档标题，或者页码位置交错）。Spire.Doc 通过 DifferentOddAndEvenPages 属性和相应的 OddPageHeader/EvenPageHeader 对象来支持这一高级功能。

scss 复制代码

import com.spire.doc.*;
import com.spire.doc.documents.*;
import com.spire.doc.fields.TextRange;

import java.awt.*;

public class insertHeaderAndFooter {

    public static void main(String[] args) {

        //创建 Document 类的对象
        Document document = new Document();

        //载入Word文档
        document.loadFromFile("人类：交织的生命.docx");

        //获取文档第一节
        Section section = document.getSections().get(0);

        //设置奇数页和偶数页的页眉、页脚不同
        section.getPageSetup().setDifferentOddAndEvenPagesHeaderFooter(true);

        //调用自定义的 insertHeaderAndFooterOddEven() 方法来插入不同的页眉和页脚到奇数页和偶数页
        insertHeaderAndFooterOddEven(section);

        //保存文档
        document.saveToFile("奇数页偶数页页眉和页脚.docx", FileFormat.Docx);
    }

    private static void insertHeaderAndFooterOddEven(Section section) {

        //插入页眉到奇数页
        Paragraph P1 = section.getHeadersFooters().getOddHeader().addParagraph();
        TextRange OH = P1.appendText("奇数页页眉");
        P1.getFormat().setHorizontalAlignment(HorizontalAlignment.Center);
        OH.getCharacterFormat().setFontName("黑体");
        OH.getCharacterFormat().setFontSize(16);
        OH.getCharacterFormat().setTextColor(Color.BLUE);
        P1.getFormat().getBorders().getBottom().setBorderType(BorderStyle.Single);
        P1.getFormat().getBorders().getBottom().setLineWidth(1f);

        //插入页眉到偶数页
        Paragraph P2 = section.getHeadersFooters().getEvenHeader().addParagraph();
        TextRange EH = P2.appendText("偶数页页眉");
        P2.getFormat().setHorizontalAlignment(HorizontalAlignment.Center);
        EH.getCharacterFormat().setFontName("黑体");
        EH.getCharacterFormat().setFontSize(16);
        EH.getCharacterFormat().setTextColor(Color.BLUE);
        P2.getFormat().getBorders().getBottom().setBorderType(BorderStyle.Single);
        P2.getFormat().getBorders().getBottom().setLineWidth(1f);

        //插入页脚到奇数页
        Paragraph P3 = section.getHeadersFooters().getOddFooter().addParagraph();
        TextRange OF = P3.appendText("奇数页页脚");
        P3.getFormat().setHorizontalAlignment(HorizontalAlignment.Center);
        OF.getCharacterFormat().setFontName("黑体");
        OF.getCharacterFormat().setFontSize(16);
        OF.getCharacterFormat().setTextColor(Color.BLUE);
        P3.getFormat().getBorders().getTop().setBorderType(BorderStyle.Single);
        P3.getFormat().getBorders().getTop().setLineWidth(1f);

        //插入页脚到偶数页
        Paragraph P4 = section.getHeadersFooters().getEvenFooter().addParagraph();
        TextRange EF = P4.appendText("偶数页页脚");
        EF.getCharacterFormat().setFontName("黑体");
        EF.getCharacterFormat().setFontSize(16);
        P4.getFormat().setHorizontalAlignment(HorizontalAlignment.Center);
        EF.getCharacterFormat().setTextColor(Color.BLUE);
        P4.getFormat().getBorders().getTop().setBorderType(BorderStyle.Single);
        P4.getFormat().getBorders().getTop().setLineWidth(1f);
    }
}

总结

通过本文的详细讲解和代码示例，您应该已经掌握了如何利用 Spire.Doc for Java 库在 Word 文档中灵活插入各种类型的页眉页脚。无论是统一的通用页眉页脚、针对首页的特殊设置，还是满足专业排版需求的奇偶页不同页眉页脚，Spire.Doc 都提供了直观且强大的 API 支持。这些功能不仅能显著提升您在 Java 应用中处理 Word 文档的效率，更能帮助您生成专业、规范的文档，极大地增强了 Java 在文档自动化领域的应用价值。在实际开发中，根据具体需求灵活运用这些技巧，将使您的文档处理工作事半功倍。