Python自动化Word页眉页脚：Spire.Doc首页奇偶页设置

脚本专家

在批量处理 Word 文档时，页眉页脚往往比正文排版更容易出现重复劳动和规则错乱，尤其是封面不显示页眉、双面打印奇偶页位置不同、页码需要随页数变化等场景。本文围绕 Spire.Doc for Python 的对象模型，把常见页眉页脚操作拆成可复用函数，说明文本、图片、页码域、页眉表格以及首页/奇偶页差异化的代码实现和参数注意点。

环境准备

本文示例使用 Spire.Doc for Python，通过 pip 安装：

2. pip install Spire.Doc

复制代码

安装后在脚本中导入模块：

2. from spire.doc import *
3. from spire.doc.common import *

复制代码

一、页眉页脚中写入文本、图片和页码

页眉通常放文档标题、公司名称或 Logo，页脚多用于页码。该库通过 Section.HeadersFooters.Header 和 Section.HeadersFooters.Footer 分别获取页眉、页脚对象，再向其中添加段落和内容。下面的函数把操作封装起来，便于对多个节复用，同时演示图片、文本、边框和页码域的组合使用：

2. def InsertHeaderAndFooter(section):
3.     header = section.HeadersFooters.Header
4.     footer = section.HeadersFooters.Footer
6.     headerParagraph = header.AddParagraph()
7.     headerPicture = headerParagraph.AppendPicture('Header.png')
8.     text = headerParagraph.AppendText('添加页眉')
9.     text.CharacterFormat.FontName = '宋体'
10.     text.CharacterFormat.FontSize = 10
11.     text.CharacterFormat.Italic = True
12.     headerParagraph.Format.HorizontalAlignment = HorizontalAlignment.Right
13.     headerParagraph.Format.Borders.Bottom.BorderType = BorderStyle.Single
14.     headerParagraph.Format.Borders.Bottom.Space = 0.05
16.     headerPicture.TextWrappingStyle = TextWrappingStyle.Behind
17.     headerPicture.HorizontalOrigin = HorizontalOrigin.Page
18.     headerPicture.HorizontalAlignment = ShapeHorizontalAlignment.Left
19.     headerPicture.VerticalOrigin = VerticalOrigin.Page
20.     headerPicture.VerticalAlignment = ShapeVerticalAlignment.Top
22.     footerParagraph = footer.AddParagraph()
23.     footerPicture = footerParagraph.AppendPicture('Footer.png')
24.     footerPicture.TextWrappingStyle = TextWrappingStyle.Behind
25.     footerPicture.HorizontalOrigin = HorizontalOrigin.Page
26.     footerPicture.HorizontalAlignment = ShapeHorizontalAlignment.Left
27.     footerPicture.VerticalOrigin = VerticalOrigin.Page
28.     footerPicture.VerticalAlignment = ShapeVerticalAlignment.Bottom
30.     footerParagraph.AppendText('第 ')
31.     footerParagraph.AppendField('页码', FieldType.FieldPage)
32.     footerParagraph.AppendText('页 共 ')
33.     footerParagraph.AppendField('页数', FieldType.FieldNumPages)
34.     footerParagraph.AppendText('页')
35.     footerParagraph.Format.HorizontalAlignment = HorizontalAlignment.Center
36.     footerParagraph.Format.Borders.Top.BorderType = BorderStyle.Single
37.     footerParagraph.Format.Borders.Top.Space = 0.05
39. document = Document()
40. document.LoadFromFile('示例文档.docx')
41. section = document.Sections.get_Item(0)
42. InsertHeaderAndFooter(section)
43. document.SaveToFile('添加页眉页脚.docx', FileFormat.Docx)
44. document.Close()

复制代码

这里有两个关键点。第一，页码必须使用域字段 FieldType.FieldPage 与 FieldType.FieldNumPages，不能手动填写固定数字，否则文档页数变化后页码会错位。第二，页眉页脚中的图片通过 HorizontalOrigin.Page 和 VerticalOrigin.Page 以页面为参照定位，配合 TextWrappingStyle.Behind 衬于文字下方，可以避免挤压正文区域。

二、在页眉中插入表格

有些场景需要在页眉放置出版号、日期、文档编号等结构化信息。该库支持直接在页眉中添加表格，行高、单元格对齐方式、背景色都可以逐项设置：

2. def InsertTableToHeader(section):
3.     header = section.HeadersFooters.Header
4.     tableHeader = header.AddTable(True)
5.     tableHeader.ResetCells(2, 2)
6.     data = [['出版号', '日期'], ['SC12546', '2019年7月24日']]
7.     for i in range(len(data)):
8.         dataRow = tableHeader.Rows.get_Item(i)
9.         dataRow.Height = 20
10.         dataRow.HeightType = TableRowHeightType.Exactly
11.         dataRow.RowFormat.BackColor = Color.Empty()
12.         for c in range(len(data[i])):
13.             dataRow.Cells[c].CellFormat.VerticalAlignment = VerticalAlignment.Middle
14.             dataRow.Cells[c].CellFormat.HorizontalAlignment = HorizontalAlignment.Center
15.             range = dataRow.Cells[c].AddParagraph().AppendText(data[i][c])
16.             range.CharacterFormat.FontName = '宋体'

复制代码

需要注意，页眉表格会占用页眉区域高度。如果表格行数较多，应同步调整 section.PageSetup.HeaderDistance，避免正文被向下推挤。

三、首页不同的处理方式

正式报告常要求封面不显示页眉页脚。将 DifferentFirstPageHeaderFooter 设为 True 后，第一节的第一页会使用独立的 FirstPageHeader 和 FirstPageFooter 容器，其余页面仍然使用常规的 Header 与 Footer：

2. section.PageSetup.DifferentFirstPageHeaderFooter = True
4. p1 = section.HeadersFooters.FirstPageHeader.AddParagraph()
5. p1.Format.HorizontalAlignment = HorizontalAlignment.Left
6. r1 = p1.AppendText('首页页眉')
7. r1.CharacterFormat.FontName = '宋体'
8. r1.CharacterFormat.FontSize = 12
10. p2 = section.HeadersFooters.FirstPageFooter.AddParagraph()
11. p2.Format.HorizontalAlignment = HorizontalAlignment.Left
12. r2 = p2.AppendText('首页页脚')
13. r2.CharacterFormat.FontName = '宋体'
14. r2.CharacterFormat.FontSize = 12
16. p3 = section.HeadersFooters.Header.AddParagraph()
17. p3.Format.HorizontalAlignment = HorizontalAlignment.Right
18. r3 = p3.AppendText('非首页页眉')
19. r3.CharacterFormat.FontName = '微软雅黑'
20. r3.CharacterFormat.FontSize = 14
22. p4 = section.HeadersFooters.Footer.AddParagraph()
23. p4.Format.HorizontalAlignment = HorizontalAlignment.Right
24. r4 = p4.AppendText('非首页页脚')
25. r4.CharacterFormat.FontName = '微软雅黑'
26. r4.CharacterFormat.FontSize = 14

复制代码

开启“首页不同”后，FirstPageHeader 与 FirstPageFooter 是独立对象。只要不向其中添加任何内容，封面就不会显示页眉页脚，无需额外执行清除操作。

四、奇偶页不同的处理方式

双面打印装订时，页码通常要求靠外侧对齐。开启 DifferentOddAndEvenPagesHeaderFooter 后，需要分别操作 OddHeader、OddFooter 与 EvenHeader、EvenFooter。按原文说明，原先设置在 Header / Footer 上的内容只对奇数页生效，偶数页要单独设置 Even 容器：

2. section.PageSetup.DifferentOddAndEvenPagesHeaderFooter = True
4. P3 = section.HeadersFooters.OddHeader.AddParagraph()
5. OH = P3.AppendText('奇数页页眉')
6. P3.Format.HorizontalAlignment = HorizontalAlignment.Center
7. OH.CharacterFormat.FontName = '微软雅黑'
8. OH.CharacterFormat.FontSize = 10
10. P2 = section.HeadersFooters.OddFooter.AddParagraph()
11. OF = P2.AppendText('奇数页页脚')
12. P2.Format.HorizontalAlignment = HorizontalAlignment.Center
13. OF.CharacterFormat.FontName = '微软雅黑'
14. OF.CharacterFormat.FontSize = 10
16. P4 = section.HeadersFooters.EvenHeader.AddParagraph()
17. EH = P4.AppendText('偶数页页眉')
18. P4.Format.HorizontalAlignment = HorizontalAlignment.Center
19. EH.CharacterFormat.FontName = '微软雅黑'
20. EH.CharacterFormat.FontSize = 10
22. P1 = section.HeadersFooters.EvenFooter.AddParagraph()
23. EF = P1.AppendText('偶数页页脚')
24. EF.CharacterFormat.FontName = '微软雅黑'
25. EF.CharacterFormat.FontSize = 10
26. P1.Format.HorizontalAlignment = HorizontalAlignment.Center

复制代码

两个开关可以叠加使用。如果同时开启首页不同与奇偶页不同，需要确保 FirstPageHeader、OddHeader、EvenHeader 三个容器都有明确的处理逻辑，避免某类页面出现空白页眉或残留内容。另外，HeadersFooters 是按节独立管理的，多节文档需要遍历 document.Sections 逐节设置，不能只处理第一节。

五、调整页眉页脚与正文的距离

页眉页脚区域高度由 HeaderDistance 和 FooterDistance 控制，单位为磅（pt）。默认值通常为 36 pt，适合单行小字。如果页眉中放入较高的 Logo 或表格，或者页脚内容较多，正文可能被向下推挤，此时可以适当调小这两个值，让页眉页脚更贴近页面边缘：

2. section.PageSetup.HeaderDistance = 30
3. section.PageSetup.FooterDistance = 30

复制代码

调整时要注意，HeaderDistance 过小可能导致页眉内容被裁切，建议结合页边距一起考虑。正文的上边距至少应大于页眉距离加上页眉实际高度。

六、实践要点

1. 页码使用 FieldType.FieldPage 与 FieldType.FieldNumPages 域字段，不要写固定数字，避免页数变化后错位。

2. HeadersFooters 按节独立管理，多节文档需遍历 document.Sections 逐节设置，并留意节与节之间是否存在继承关系。

3. 首页不同、奇偶页不同可以叠加，但要分别处理 FirstPageHeader、OddHeader、EvenHeader 等容器，避免出现空白页眉或残留内容。

4. 页眉中放图片或表格时，要同步检查 HeaderDistance 和正文页边距，防止正文被推挤或页眉被裁切。

5. 如果文档结构复杂，建议先在 Word 中理清各节页眉页脚设置状态，再编写脚本，避免代码与文档实际状态不一致。不同文档处理库在页眉页脚对象模型上也有差异，迁移代码时需要留意容器名称和定位方式的对应关系。

热心网友5

感谢分享，内容挺实用的。把页眉页脚操作封装成函数，对多节文档复用很友好；页码用 FieldPage 和 FieldNumPages 这两个域字段这点也很关键，手动填固定数字确实容易出错。图片以页面为参照定位、配合 Behind 避免挤压正文，也讲得比较清楚。 不过标题提到的首页不显示页眉、奇偶页不同这些差异化设置，正文里好像还没展开；页眉表格那段代码也像是没贴完。期待后续把首页/奇偶页设置和表格部分补全，整体会更完整。

热心网友5

感谢分享，这套把页眉页脚操作封装成函数的思路很实用，尤其适合一次处理多个节或多个文档的场景。文里提到的两个注意点我很有共鸣：页码一定要用 FieldPage 和 FieldNumPages 这类域字段，手动写死数字在文档页数变化后确实容易出问题；图片用 HorizontalOrigin.Page 和 VerticalOrigin.Page 配合 Behind 衬于文字下方，也能避免把正文区域挤乱，这个细节对排版要求高的文档很关键。 另外有个小提醒，正文在“二、在页眉中插入表格”那里好像没贴完，表格数据只显示到“SC”就断了，后面首页不显示页眉、奇偶页差异化设置的部分也还没展开。如果方便的话，可以把表格插入的完整示例和首页奇偶页的设置代码补上，特别是奇偶页不同页眉时 Sections 里相关属性的开启顺序和注意事项，这部分对双面打印场景会很有帮助。整体内容已经很有参考价值了，期待后续。

热心网友5

楼主的思路很实用，把页眉页脚操作封装成函数确实方便对多个节复用，批量处理文档时能省掉不少重复代码。几个细节我也很有同感：页码用 FieldType.FieldPage 和 FieldType.FieldNumPages 这两个域字段而不是写死数字，这一点非常关键，不然文档页数一变页码就对不上了；还有页眉页脚里的图片用 HorizontalOrigin.Page、VerticalOrigin.Page 再配合 TextWrappingStyle.Behind 定位，确实能避免图片把正文区域挤变形的问题。表格那部分用 AddTable 之后 ResetCells 再逐格设置，对出版号、日期这类结构化信息很合适。 另外想请教一下，首帖提到封面不显示页眉和奇偶页位置不同，但后面的内容好像被截断了。我猜应该是通过节属性里的 DifferentFirstPageHeaderFooter 和 OddAndEvenPagesHeaderFooter 来打开开关，然后再分别取 FirstPageHeader、EvenPageHeader 这些对象来设置，不知道实际操作时有没有什么坑，比如开启奇偶页之后原来的 Header 是落到奇数页还是需要重新赋值。还有多节文档遍历时，如果某节不想要页眉页脚，是不是要单独处理或者断开与前一节页眉的链接。期待楼主把后面的部分补完，尤其是首页和奇偶页差异化那一块，感觉