在現代企業應用中，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 依賴配置：

<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 等。以下代碼演示了如何加載一個文檔（或新建文檔），設置其頁眉和頁腳內容，并保存。

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);}
}

Java 實現 Word 文檔首頁面獨立頁眉頁腳

有時，我們希望文檔的第一頁擁有一個獨特的頁眉頁腳（例如，封面頁可能只顯示 Logo，而不顯示頁碼），而后續頁面則使用常規的頁眉頁腳。Spire.Doc 提供 DifferentFirstPage 屬性來實現此功能。

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 對象來支持這一高級功能。

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 在文檔自動化領域的應用價值。在實際開發中，根據具體需求靈活運用這些技巧，將使您的文檔處理工作事半功倍。