1. 为什么选 Spire.Doc 来做奇偶页页眉/页脚

1.1 需求的真实来源：标书、合同和书籍的固定排版规则

做 .NET 文档自动化的同学，十有八九会遇到“奇偶页页眉/页脚”这个需求。尤其标书、合同、毕业论文、产品手册这类正式文档，排版规则几乎是固定的：奇数页页眉放公司名或章节名，偶数页页眉放文档简称；页脚页码也不能老老实实居中，常见做法是奇数页页码靠右、偶数页页码靠左，方便装订后翻页时页码始终在外侧。

这种需求在 Word 里手动设置非常简单，勾一下“奇偶页不同”就行。但要放到 .NET 程序里批量生成几百份文档，就没那么轻松了。我最早尝试过 COM 调 Word，功能确实全，但服务器上稳定性很让人头疼：Office 组件版本不一致、并发创建进程崩溃、杀毒软件拦截…… 后来切到 Spire.Doc，代码量直接砍掉一大半，也不依赖 Office 环境，今天就把奇偶页页眉/页脚这一块的最佳实践完整梳理出来，适合正在用或准备用 Spire.Doc 做文档自动化的 .NET 开发者参考。

1.2 Spire.Doc 与 Open XML SDK、COM 的取舍

先说结论：.NET 生态里做文档自动化，常见方案有三个，各有利弊。我把它们的核心差异放在一张表里，方便你根据项目约束选型。

我个人的建议是：如果项目是服务端批量出文档，且预算允许，优先用 Spire.Doc 这类商业库。理由很实在，它把 Open XML SDK 里大量繁琐的 XML 操作封装成了直观的对象，比如Section.HeadersFooters.Header、HeadersFooters.EvenFooter，代码读起来就和 Word 里的操作顺序差不多，后期维护成本低。如果你所在公司有严格的合规要求，不引入商业组件，那就用 Open XML SDK，但你要有心理准备：光是一个“奇偶页开关”，就要去settings.xml里找w:evenAndOddHeaders节点，处理不好很容易出错。

1.3 奇偶页页眉/页脚在 Word 对象模型里到底是怎么存的

这里有个非常关键的坑，必须先讲清楚。

很多人以为“奇偶页不同”是每个节（Section）的属性，毕竟它显示在“页面设置 → 版式”里。但 Word 的 docx 本质是一个 zip 包，奇偶页开关evenAndOddHeaders其实存在文档级别的设置里，也就是/word/settings.xml，不是节属性。这意味着什么？意味着你必须先在整个文档层面打开“奇偶页不同”的开关，然后在每个节里分别给奇数页页眉、偶数页页眉、奇数页页脚、偶数页页脚填内容。

Spire.Doc 对应的做法就是先设置文档设置，再操作节里的页眉页脚对象。打开开关后，每个节里会有这几类页眉页脚：

• HeadersFooters.Header：默认页眉，奇偶页开启后被当作奇数页页眉使用
• HeadersFooters.EvenHeader：偶数页页眉
• HeadersFooters.Footer：默认页脚，对应奇数页页脚
• HeadersFooters.EvenFooter：偶数页页脚
• HeadersFooters.FirstPageHeader / FirstPageFooter：首页页眉和页脚，那是另一个开关，别混淆

如果不先打开奇偶页开关，就算你往EvenHeader里写了内容，Word 打开后大概率也不显示。这是新手最容易踩的坑，我见过的排查记录里，至少有三分之一的问题出在这一步。

2. 动手前的准备：环境、依赖和文档结构认知

2.1 项目环境与 NuGet 包选择

Spire.Doc 是纯托管程序集，不需要服务器安装 Office，这一点非常香。我的演示环境是 .NET 8，控制台应用，Windows 11，但你用 .NET 6 或 .NET Framework 4.6.2+ 也差不多，具体看 NuGet 包的目标框架说明。

安装很简单，命令行执行：

dotnet add package Spire.Doc

如果你只想本地验证功能，也可以装Spire.Doc.Free。但注意，免费版对文档段落数、页数或者图片数量有严格限制，做正式批量输出时很容易触发异常，生产环境建议走商业授权，别在交付阶段被坑。

2.2 理解 Spire.Doc 的文档模型层级

用 Spire.Doc 写代码前，先把它的对象模型捋一遍。它和 Word 的结构非常像，一层套一层：

• Document：整个文档，相当于磁盘上的 docx 文件
• Section：文档里的节，一个文档可以有多个节，节与节之间靠分节符划分
• Paragraph：段落，正文里的每一行文字基本都是一个段落
• HeaderFooter：页眉或页脚容器，挂在Section.HeadersFooters下

可以理解成一本实体书：书是一整个文档，每一章是一个节，每章里自然有正文段落，页眉页脚则是印在每一页顶部或底部的固定内容。你往某个节的页眉里写东西，控制的就是这一节范围内的页面顶部区域。

2.3 偶数页页眉页脚与正文分节的关系

分节是个大话题，这里只强调和奇偶页直接相关的点。

一个文档可能只有一个节，也可能有封面节、目录节、正文节。奇偶页开关是整个文档级别的，但页眉页脚的内容是按节分别存储的。如果你有多个节，每个节都可以有自己独立的奇数页页眉、偶数页页眉。新节默认会“继承”前一个节的页眉页脚，也就是所谓链接到上一节；如果想让某一章的页眉和前一章不一样，必须断开这个链接，否则你改了第一节的偶数页页眉，后面所有节都会被带跑。

所以写代码前先想清楚：这个文档是全篇一套页眉，还是每章单独一套？全篇一套就只配置第一个节，后续节保持继承；每章不同就得逐节断开再配置。别图省事只写第一节，等客户打开文档发现第二章页眉错了，排查起来更费劲。

3. 核心实现：用 Spire.Doc 设置奇偶页页眉/页脚

3.1 第 1 步：创建文档并开启奇偶页开关

新建一个Document，然后立刻设置奇偶页开关：

Document doc = new Document(); doc.Settings.EvenAndOddHeaders = true;

这行代码至关重要。EvenAndOddHeaders属性位于文档设置对象下，不是节属性。如果你用的 Spire.Doc 版本比较老，找不到这个属性，不要瞎找，直接把 NuGet 包升级到最新版最省事。

提示：设置完这个开关后，HeadersFooters.Header会被 Word 当作奇数页页眉使用。所以代码里写“奇数页页眉”时，不要找OddHeader这样的属性，Spire.Doc 里没有，它就叫Header。

3.2 第 2 步：准备多页正文和节

奇偶页效果要真的看得见，文档里至少得有 3 到 4 页。我平时测试会先加一个节，再循环补一些正文段落把文档撑到多页：

Section section = doc.AddSection(); section.PageSetup.PageWidth = 595.3f; section.PageSetup.PageHeight = 841.9f; section.PageSetup.Margins.Left = 72f; section.PageSetup.Margins.Right = 72f; section.PageSetup.Margins.Top = 72f; section.PageSetup.Margins.Bottom = 72f; for (int i = 1; i <= 20; i++) { Paragraph body = section.AddParagraph(); body.AppendText($"这是用于撑页数的第 {i} 段正文，实际项目中会被真实内容替换。"); }

这里的尺寸单位是点（pt），595.3 x 841.9 正好是 A4 纵向。页边距 72pt 相当于 Word 里默认的 2.54 厘米。如果你做的是 16 开书刊或者自定义纸张，需要按实际尺寸调整。

3.3 第 3 步：分别操作奇数页页眉/页脚与偶数页页眉/页脚

接下来是核心。我习惯把页眉页脚的配置封装成一个独立方法，参数直接传页眉文本和页码样式，这样批量场景好复用。先看获取页眉页脚对象的方式：

HeaderFooter header = section.HeadersFooters.Header; // 奇数页页眉 HeaderFooter evenHeader = section.HeadersFooters.EvenHeader; // 偶数页页眉 HeaderFooter footer = section.HeadersFooters.Footer; // 奇数页页脚 HeaderFooter evenFooter = section.HeadersFooters.EvenFooter; // 偶数页页脚

每个新页眉默认自带一个空段落，直接操作Paragraphs[0]就行。如果遇到自己创建的复杂页眉对象，Paragraphs数量可能为 0，那就先AddParagraph()再写。我在示例里写了个小工具方法，规避这个不确定性。

页眉文字可以直接用段落对象的Text属性赋值，也可以追加带格式的文本。页脚如果要插入页码，用域字段：

footer.Paragraphs[0].AppendField("PAGE", FieldType.FieldPage);

FieldType.FieldPage就是 Word 里的 PAGE 域，生成后会自动显示当前页码，不需要手工算。这里要注意：页脚段落的Text属性赋值和AppendField不要混着乱用，先用工具方法清空默认内容，再统一追加，避免文字和域堆在一起。

3.4 第 4 步：保存并验证生成的 docx

保存很简单：

doc.SaveToFile("output.docx", FileFormat.Docx);

但“保存成功”不等于“排版正确”。我强烈建议保存后做一次人工验证：用 Word 或 WPS 打开，切到“页面视图”，滚动几页看看奇数页和偶数页的页眉页脚是否交替出现。你也可以把 docx 文件改名为 zip，解压后打开word/settings.xml，里面应该能看到<w:evenAndOddHeaders/>这样的节点，这是最底层的确认方式。

3.5 可直接复制的完整示例

把上面的步骤串起来，完整代码如下：

using Spire.Doc; using Spire.Doc.Documents; using Spire.Doc.Fields; namespace OddEvenHeaderFooterDemo { internal class Program { static void Main(string[] args) { Document doc = new Document(); doc.Settings.EvenAndOddHeaders = true; Section section = doc.AddSection(); section.PageSetup.PageWidth = 595.3f; section.PageSetup.PageHeight = 841.9f; section.PageSetup.Margins.Left = 72f; section.PageSetup.Margins.Right = 72f; section.PageSetup.Margins.Top = 72f; section.PageSetup.Margins.Bottom = 72f; for (int i = 1; i <= 20; i++) { Paragraph body = section.AddParagraph(); body.AppendText($"这是用于撑页数的第 {i} 段正文，实际项目中会被真实内容替换。"); } ConfigureOddsAndEvens(section, "XX公司投标文件", "技术方案", "TH-2024-001"); doc.SaveToFile("output.docx", FileFormat.Docx); System.Console.WriteLine("生成完成，请用 Word 打开检查奇偶页效果。"); } static void ConfigureOddsAndEvens( Section section, string oddHeaderText, string evenHeaderText, string docNumber) { // 奇数页页眉：右侧显示标题，左侧不放内容 HeaderFooter header = section.HeadersFooters.Header; Paragraph headerPara = GetFirstParagraph(header); headerPara.Format.HorizontalAlignment = HorizontalAlignment.Right; headerPara.AppendText(oddHeaderText); // 偶数页页眉：左侧显示文档编号 HeaderFooter evenHeader = section.HeadersFooters.EvenHeader; Paragraph evenHeaderPara = GetFirstParagraph(evenHeader); evenHeaderPara.Format.HorizontalAlignment = HorizontalAlignment.Left; evenHeaderPara.AppendText($"{evenHeaderText} {docNumber}"); // 奇数页页脚：页码靠右 HeaderFooter footer = section.HeadersFooters.Footer; Paragraph footerPara = GetFirstParagraph(footer); footerPara.Format.HorizontalAlignment = HorizontalAlignment.Right; footerPara.AppendText("第 "); footerPara.AppendField("PAGE", FieldType.FieldPage); footerPara.AppendText(" 页"); // 偶数页页脚：页码靠左 HeaderFooter evenFooter = section.HeadersFooters.EvenFooter; Paragraph evenFooterPara = GetFirstParagraph(evenFooter); evenFooterPara.Format.HorizontalAlignment = HorizontalAlignment.Left; evenFooterPara.AppendText("第 "); evenFooterPara.AppendField("PAGE", FieldType.FieldPage); evenFooterPara.AppendText(" 页"); } static Paragraph GetFirstParagraph(HeaderFooter headerFooter) { if (headerFooter.Paragraphs.Count == 0) { return headerFooter.AddParagraph(); } // 只保留第一个段落，内容清空，避免旧内容残留 while (headerFooter.Paragraphs.Count > 1) { headerFooter.Paragraphs.RemoveAt(headerFooter.Paragraphs.Count - 1); } headerFooter.Paragraphs[0].Text = string.Empty; return headerFooter.Paragraphs[0]; } } }

跑完这个示例，用 Word 打开output.docx，你应该看到奇数页页眉靠右、偶数页页眉靠左，页码同样一右一左。这就是最常见的装订排版规则。

4. 直接改已有 Word 文档的奇偶页设置

4.1 识别已有文档是否已开启奇偶页

很多时候你拿到的是一份现成的 Word 模板，可能是客户提供的标书框架，也可能是老同事留下的合同模板。这时候不需要从零建文档，而是加载后判断并修改。

Document doc = new Document("template.docx"); bool alreadyEnabled = doc.Settings.EvenAndOddHeaders; Console.WriteLine($"当前文档奇偶页设置：{alreadyEnabled}");

如果alreadyEnabled是 false，先补上开关；如果是 true，说明模板本身已经开启了奇偶页，你只需要检查各节页眉页脚内容是否符合要求。这里有个典型的误判：页面上看起来没有偶数页页眉，但开关是开着的，可能只是EvenHeader里的内容是空的，Word 不显示空页眉而已。别急着关开关，先查内容。

4.2 给现有文档单独加偶页码并断开链接

假设模板已经开启奇偶页，但偶数页页脚没有页码。我们只需要锁定目标节，给偶数页页脚追加 PAGE 域。不过改已有文档前要特别注意节的链接关系，如果当前节继承自上一节，你改完可能发现上一节的偶数页也变了，或者改完无效。

Document doc = new Document("template.docx"); doc.Settings.EvenAndOddHeaders = true; foreach (Section section in doc.Sections) { HeaderFooter evenFooter = section.HeadersFooters.EvenFooter; // 断开与前一节的链接，确保只影响当前节 evenFooter.IsLinkedToPrevious = false; Paragraph p = evenFooter.Paragraphs.Count > 0 ? evenFooter.Paragraphs[0] : evenFooter.AddParagraph(); p.Text = string.Empty; p.Format.HorizontalAlignment = HorizontalAlignment.Left; p.AppendField("PAGE", FieldType.FieldPage); } doc.SaveToFile("template_updated.docx", FileFormat.Docx);

使用IsLinkedToPrevious = false是这里的关键操作，相当于 Word 界面里的“取消链接到前一节”。这个属性在新建文档的多个节之间同样适用，是控制页眉页脚独立性的核心。

5. 常见问题与排查技巧实录

5.1 设置不生效？先检查文档设置而不是节设置

页眉页脚写了一大堆代码，生成后打开却发现什么变化都没有，这是最高频的问题。先别怀疑页眉内容，按下面顺序排查：

• 是否执行了doc.Settings.EvenAndOddHeaders = true;
• 页眉内容是否写在了正确的Section上
• 文档是否有多个节，页眉是否被后续节继承覆盖
• 打开文件的 Word 视图是否在“页面视图”

其中第一点最容易被忽略。Spire.Doc 里即使你没开奇偶页开关，往EvenHeader写内容也不会报错，所以问题特别隐蔽。我在 1.3 节里说过原因：奇偶页开关是文档级设置，不在节属性里。遇到不生效，第一步就去打印doc.Settings.EvenAndOddHeaders的值。

5.2 偶数页页眉跑到“下一页”甚至完全看不到

这个现象通常不是代码问题，而是对页面序号的预期错了。Word 默认第一页是奇数页，如果你的文档开头有封面，封面是第 1 页（奇数页）；封面后面的目录如果是直接连续排版，它可能是第 2 页（偶数页）。那么“偶数页页眉”会先出现在目录这一页上，而不是你以为的第 3 页。

所以要理解：页眉页脚是按“物理页码的奇偶性”渲染的，不按内容类型渲染。想让某章固定从奇数页开始，需要设置节的起始方式，让节从奇数页新起一页。Spire.Doc 里这属于节的分隔属性，比如设置SectionStart.OddPage之类的枚举值来控制节起始位置。这类排版需求通常和论文、标书的“每一章必须从右页开始”配套出现，建议先跟需求方确认清楚再动手。

5.3 页眉或页脚多出一行空段落

生成后打开文档，页眉里总有一行多余的空行，页眉线也跟着往下掉。多数字段是页眉里原本就有多个空段落，或者你的工具方法没有清理干净。

我的习惯是像上面代码里那样，写一个GetFirstParagraph工具方法：先确保至少有一个段落，然后从尾部往前删掉多余段落，最后清空第一段内容。这样不管拿到的页眉对象是干净的还是残留内容的，最终都会落到一个确定状态。删段落时要倒着删，从Paragraphs.Count - 1循环到 1，避免索引错乱。

5.4 多节文档：后续节被前节“带跑”

你只改了第一个节的页眉，结果整个文档的页眉都变成了你写的这个；或者你改了第二节，第一节也跟着变。这还是链接关系搞的鬼，两个节之间如果存在页眉继承关系，修改一个会联动另一个。

实战经验是：做多节文档前，先写一个遍历所有节的小工具，打印每个节的IsLinkedToPrevious状态。全篇统一页眉时，保持继承关系反而省事，只需要改第一处；如果每节不同，必须逐个断开。判断依据很简单，问自己一个问题：这个文档里所有的页眉页脚是不是完全一样？是就只配第一节，不是就逐节断开后独立配置。

5.5 生成 PDF 或转图后奇偶页内容丢失

Spire.Doc 也可以直接保存成 PDF，很多项目会在服务端把 docx 转成 PDF 发给客户。有时候 Word 里看着好好的，PDF 里偶数页页眉却不显示。

我先说结论：绝大多数情况不是业务代码错了，而是文档里页眉页脚包含的域字段（比如 PAGE）在转换时没有被正确刷新生效。遇到这种问题，先检查源 docx 在 Word 里是否正常；如果 Word 正常而 PDF 异常，优先升级 Spire.Doc 版本，或者显式刷新一次所有域。另外，PDF 的“奇偶页”表现依赖打印设置，看 PDF 预览时要注意页面缩放比例，别把内容误判成丢失。

5.6 批量大文件时的内存与免费版限制

批量生成几十上百份文档时，最容易踩的是内存和授权限制两个坑。免费版对文档复杂度和规模有限制，跑到一半就异常退出，或者输出文档被截断；而自己写循环时如果每份文档都 new 一个Document对象，处理完又不释放，内存会持续飙升。

我的做法是把批量任务拆成小步循环，每处理完一份就调用一次GC.Collect()强制回收，数量特别大时甚至每份文档放进独立子进程，彻底杜绝内存泄漏。买商业授权也别拖到最后，服务端自动化不是本地玩两下，正式环境用的组件最好一开始就走正规授权，省得后期被安全合规卡脖子。

6. 批量场景下的模板复用与配置化建议

6.1 用已有模板文件替代纯代码排版

从 3.5 节的示例能看出来，纯代码创建文档虽然灵活，但要连页面大小、页边距、页眉样式全部写一遍，代码会比较长。实际项目里我更推荐“模板 + 数据填充”的组合：

• 先用 Word 做好一版标准模板，里面配好页面设置、奇偶页开关、页眉内容、页脚的页码域
• 程序里用new Document("template.docx")加载模板
• 只替换需要变化的文字内容，比如公司名、项目编号、客户名称等

这样做的好处非常明显：排版细节由视觉人员在 Word 里把控，程序员只关心数据填充，职责边界清晰，格式调整也不需要重新发版。奇偶页页眉页脚这种“反反复复微调”的排版，尤其适合在模板阶段就定死，而不是在代码里天天改。

6.2 把奇偶页配置封装成策略对象

如果公司的文档规则比较复杂，比如 A 类标书用公司全称做奇数页页眉，B 类合同用项目编号做偶数页页眉，不同文档类型规则还不一样，那就别写一堆 if else 分支。我会定义一个配置类，把字段全部集中起来：

class OddEvenHeaderOptions { public string OddHeaderText { get; set; } public string EvenHeaderText { get; set; } public bool ShowPageNumberInOddFooter { get; set; } public bool ShowPageNumberInEvenFooter { get; set; } public float PageWidth { get; set; } = 595.3f; public float PageHeight { get; set; } = 841.9f; }

配置类的好处是：业务方改需求时，我只需要提供一份新的配置数据，底层页眉页脚写入方法完全不用动。比如“页码从右侧改成左侧”，那是对齐方式的属性，一个枚举值的事；真正麻烦的是整段逻辑被互相耦合，改一处崩三处。配置化以后，这种问题基本就消失了。

最后说一个我自己的操作习惯：只要项目里出现“奇偶页不同”这几个字，我一定会先让需求方把页眉页脚的内容和 Word 里的“页面设置”截图发过来，确认后再写代码。因为奇偶页规则一旦定错，后面批量生成的几百份文件全废，返工代价太高。配置类加模板加前置确认，是我目前试下来最稳妥的组合，愿你少踩几个我用脑袋试出来的坑。