这一讲我们来看页脚。说实话，在Word文档处理这件事上，页脚是个“存在感极低但翻车率极高”的东西。你打开一份十几页的标书，页脚里无非是页码、公司名、日期，平时谁也不会盯着看，可一旦要用OpenXML SDK去读写它，各种引用链、Part类型、字段缓存的问题立马就冒出来了。
本讲是OpenXML操作Word文档系列里偏进阶的一篇，核心知识点是文档页脚类（Footer、FooterPart），包括页脚的三种类型、Part挂接方式、页码字段的插入逻辑，以及最常见的“页脚没显示”“页码全显示成1”这类坑。适合已经会创建Word文档、懂一点Part概念、想在文档结构层面真正操作页码和页脚的同学，纯小白建议先把正文段落和样式那两讲看看。
1. OpenXML里页脚到底长什么样——先搞懂数据模型
1.1 从Word UI到XML：页脚在Office Open XML里的存储结构
在Word用户界面里，你双击页面底部的空白区域，就能进入页脚编辑状态，输入文字、插页码、放图片，所见即所得。但在OpenXML的世界里，页脚不再是“页面底部的区域”，它是一份独立的XML部件（Part），挂在文档主体的某个小节（Section）上，由引用关系串联起来。
理解这一点的关键，是抓住OpenXML文档数据模型的那条主线：一个Word文档是一个压缩包，里面有很多Part，其中最重要的叫MainDocumentPart——文档主体；主体里的内容按节划分，每节有一套页面属性；节通过一个叫FooterReference的元素引用外面的某个FooterPart；真正存放页脚内容的是FooterPart里的Footer根元素。
把这个链路拆分出来就是：
document.xml（Document） └── Body └── sectPr（节属性） └── FooterReference（r:id 指向某个FooterPart） └── FooterPart └── Footer（根元素） └── Paragraph / Run / Text每个Section可以引用三种不同的页脚，分别对应三种查看场景：默认页脚、首页页脚、偶数页页脚。一个节最多挂三个FooterReference，分别通过Type属性区分。
还有一个容易忽略的点：多个Section可以引用同一个FooterPart。Word默认新建文档的所有节共用同一份页脚内容，这个“共用关系”在底层就是多个sectPr里的FooterReference指向同一个Part Id。搞清楚这点，后面调试“改了一节、全文档都变”的问题就有了方向。
1.2 页脚的三种类型编码：default、first、even
FooterReference的Type属性来自HeaderFooterValues枚举，取值有三个：
| 枚举值 | 对应场景 | 说明 |
|---|---|---|
| Default | 默认页脚 | 所有页面使用，除非命中了First或Even的规则 |
| First | 首页页脚 | 仅文档或节的首页显示 |
| Even | 偶数页页脚 | 设置“奇偶页不同”后，偶数页显示的页脚 |
这里面的优先级很容易踩坑。很多人以为First和Even是“额外页脚”，其实它们是“覆盖规则”：当某一页同时命中了首页和偶数页两个条件时，Word内部有一条明确的优先级顺序——首页优先于偶数页，且首页页脚只对节内第一页生效。
另外，如果你在Word界面里勾选了“首页不同”，系统会自动在当前节的sectPr里插入一个Type=First的FooterReference；如果你取消勾选，它只会删除这个引用，之前生成的FooterPart不一定会被清理。这就是为什么有些文档里明明没设置首页不同，你却能在压缩包里看到一个孤零零的页脚Part——别人手动删过引用但没删Part。
2. 读页脚：在不解压文档的情况下把页脚内容挖出来
2.1 顺着引用链找页脚Part的完整路径
读取页脚的第一步不是“找到FooterPart”，而是先从文档主体出发，找到所有节的sectPr，再在每个节里找FooterReference。如果直接遍历MainDocumentPart的所有Part去找FooterPart，只能拿到文档里所有页脚Part的集合，却无法知道哪个页脚对应哪一节、是哪种类型——这对于“我要读第一节的默认页脚”这类需求来说不够用。
正确的路径是先扫Body下的Paragraph。这里有个细节：sectPr可能出现在Body的直接子级（文档最后一个节的属性），也可能出现在某个Paragraph的ParagraphProperties里（节属性作为该段落的属性存在）。用SDK操作时，可以通过Body.Elements ()遍历，它会自动处理这两种位置。
拿到SectionProperties之后，用Elements ()过滤出该节的所有页脚引用。需要注意，一个sectPr里不只有一个FooterReference，必须通过Type区分default、first、even，再根据对应r:id去MainDocumentPart里找Part。
2.2 一个实际示例：读取第一页页脚文本
下面这段代码可以原样抄去用，作用是把第一节默认页脚的全部文本按行打印出来：
using DocumentFormat.OpenXml.Packaging; using DocumentFormat.OpenXml.Wordprocessing; using System.Linq; static void ReadFooterText(string filePath) { using var doc = WordprocessingDocument.Open(filePath, false); var mainPart = doc.MainDocumentPart; if (mainPart == null) return; var body = mainPart.Document.Body; var firstSection = body?.Elements<SectionProperties>().FirstOrDefault(); if (firstSection == null) return; var refElement = firstSection.Elements<FooterReference>() .FirstOrDefault(f => f.Type?.Value == HeaderFooterValues.Default); if (refElement == null) return; var footerPart = (FooterPart)mainPart.GetPartById(refElement.Id); var footer = footerPart.Footer; foreach (var para in footer.Elements<Paragraph>()) { var text = string.Concat(para.Descendants<Text>().Select(t => t.Text)); System.Console.WriteLine(text); } }这里有个值得说透的细节：Paragraph里的文字不只在Text元素里，还有可能是FieldCode、InstrText、DeletedText等。用Descendants
读取过程中的另一个关键点：WordprocessingDocument.Open的第二个参数是bool isEditable，读操作传false，写操作传true。很多人在这里图省事总是传true，一旦程序异常退出，文档就可能被锁文件，后面再跑就报“文件被占用”了。
3. 写页脚：从零开始给文档加上页码和公司名
3.1 页脚内容的组织方式：简单文本还是复杂结构
页脚的内容本质上是一个精简版的主文档主体，它的根元素Footer下面可以直接放Paragraph和Table这类块级元素。所以在操作思路上，你会觉得似曾相识——创建页脚段落跟在正文里创建段落的API是一样的，换汤不换药。
但页脚有自己的特点：它的可用宽度受限于页面设置，而且通常只放一行内容，所以实际开发中很少用复杂表格，最多就是一个Paragraph配几个Run，加上一个Tab或缩进搞定布局。
我一般会把页脚内容按“三段式”模板设计：左侧公司名、中间页码、右侧日期。要实现这种左中右分布，有两种常见手段。
第一种是用Tab位。先给段落设置一个制表位，再把Run拆成三段，中间插入Tab字符：
static Paragraph BuildFooterParagraph(string leftText, string rightText) { var para = new Paragraph(); var props = new ParagraphProperties(); var tabs = new Tabs(); tabs.Append(new TabStop() { Val = TabStopValues.Right, Position = 9360 // 约等于页面右边界位置 }); props.Append(tabs); para.Append(props); para.Append(new Run(new Text(leftText))); para.Append(new Run(new TabChar())); para.Append(new Run(new Text(rightText))); return para; }第二种是直接把段落对齐方式设为Right，左边一部分文字，后面接页码。这个方法适合“公司名 + 页码”的简单组合，不需要算制表位。
如果你的页脚需要加一条上边框线——很多人喜欢页脚上方带条横线，Word自带样式就有这个效果——别想着去画线，应该给Paragraph的ParagraphProperties添加Borders，设置Top边框的样式和粗细。这属于OpenXML里样式化的常规套路，比插入一条画线Shape更稳定。
3.2 页码字段的OpenXML写法：FldSimple和复杂域指令
页码是页脚里最常见的需求。在OpenXML中，页码不是一个Text元素，而是一个字段（Field），有简单和复杂两种写法。
简单写法用FldSimple节点，直接在字段指令里写明类型，一行搞定：
var fld = new FldSimple() { FieldCode = "PAGE" }; fld.Append(new Run(new Text("1"))); // 这个“1”只是缓存值复杂写法是Begin / InstructionText / Separate / End三段式，一般由Word自己生成。用SDK手写时，用FldSimple就足够了，Word打开时会自动重新计算显示值。
这里要特别强调缓存值的问题。你写在FldSimple里的那个Text，只是“上次显示的结果”，不是页码本身。文档在Word里打开后，如果设置了更新字段，Word会用真实页码替换它并保存。所以如果你用OpenXML写完字段后，打开文档发现每页页码都是相同的数字，不要怀疑是Insert代码写错了——那是Word的字段更新策略在起作用。
3.3 挂接页脚Part到Section的完整操作代码
把页码和公司名组成页脚内容之后，不能直接用——页脚内容是独立的Part，它和节之间必须通过FooterReference挂接。完整流程分三步：新建Part、写内容、建立引用，顺序不能乱。
static void AddSimpleFooter(string filePath) { using var doc = WordprocessingDocument.Open(filePath, true); var mainPart = doc.MainDocumentPart!; var body = mainPart.Document.Body; // 1. 新建FooterPart var footerPart = mainPart.AddNewPart<FooterPart>(); var footer = new Footer(); // 2. 往里写内容：公司名 + TabTab + PAGE字段 var para = new Paragraph(); var props = new ParagraphProperties(); props.Append(new Tabs( new TabStop() { Val = TabStopValues.Right, Position = 9360 } )); para.Append(props); para.Append(new Run(new Text("某公司"))); para.Append(new Run(new TabChar())); para.Append(new Run(new TabChar())); var pageField = new FldSimple() { FieldCode = "PAGE" }; pageField.Append(new Run(new Text("1"))); para.Append(new Run(pageField)); footer.Append(para); footerPart.Footer = footer; footerPart.Footer.Save(); // 3. 建立节引用 var sectPr = body.Elements<SectionProperties>().FirstOrDefault(); if (sectPr == null) { sectPr = new SectionProperties(); body.Append(sectPr); } sectPr.Append(new FooterReference() { Type = HeaderFooterValues.Default, Id = mainPart.GetIdOfPart(footerPart) }); mainPart.Document.Save(); }这段代码的核心逻辑集中在第31步：先AddNewPart创建FooterPart，拿返回值footerPart；然后往footerPart.Footer里放内容；再用mainPart.GetIdOfPart(footerPart)拿到Part的Id，这个Id就是FooterReference的挂接点。
有一个新手常犯的错：他们会在第1步自己给Part随便设个Id，比如“rId100”，结果Word打开后提示“文档中无法找到引用的部件”。Id必须用GetIdOfPart从主文档Part那里取，因为SDK维护的是主文档Part内部的关系表，只有这个表里登记过的Id才有效。
创建完新Part后，别忘了调用footerPart.Footer.Save()。这个Save是把Part的XML序列化到内存流里，直到主文档Save时才会真正写进压缩包。很多人漏掉这一步，导致页脚内容在内存里改了半天，压缩包里还是空文件。
4. 页脚的“隐藏规则”：多节文档里的Part共享与引用
4.1 新旧页脚的Id差异
处理多节文档时，你会碰上比单节复杂得多的引用管理问题。第一个要命的问题就是PartId冲突。
如果你用AddNewPart创建了一个FooterPart，SDK自动分配一个Id，比如rId5。同时，文档里已经存在的某个节也引用了rId5指向的另一个Part——这种情况几乎不会发生，因为自动分配的Id是全局递增的。真正的冲突场景反而是“重复添加”：你在一个已有默认页脚的节上，又追加一个Default类型的FooterReference，导致节里有两个同类型的引用。Word对这事的处理原则是“后者生效”，但它不会自动删除旧引用，结果打开文档时可能出现页脚一会儿是旧的、一会儿是新的这种怪现象。
所以写代码时要记住：在给sectPr添加FooterReference之前，先删除同类型的旧引用。
4.2 共享Part的坑：同一个页脚被多个Section引用
上个部分提过，Word文档里多个节的FooterReference完全可以指向同一个FooterPart。这个共享机制的坑在于：你用代码修改了某个FooterPart的内容，于是所有引用它的节的页脚一起变了。
举个典型例子：一份报告有封面、目录、正文三个节，封面节设置了First类型的页脚（版权声明），正文节用的是默认页脚（页码）。你只想在封面页脚里加一行公司名，结果因为封面节只引用了First类型，正文节引用的是Default类型，两者Part不同，不会互相影响——这个场景是安全的。但如果有人在操作时把封面节的First引用删掉了，又没新建Part，而是把正文节的Default引用复制了一份过来，就会导致封面和正文共用同一个Part，以后不管改哪个，另一个全变。
我建议把“Part共享”当作一个设计取舍来看待：相同的页脚内容就用共享Part，节省空间、方便统一维护；不同的页脚内容必须各建各的Part。这个判断要在写代码前就做好，而不是写完后再靠肉眼检查。
4.3 设置首页不同、奇偶页不同的正确姿势
“首页不同”和“奇偶页不同”不仅是Word界面里的复选框，在OpenXML里体现为一组引用关系。要做到首页不同，你需要在该节的sectPr里同时存在Default和First两个FooterReference，分别指向不同的FooterPart。如果两个Id相同——那等于白设置了首页不同。
奇偶页不同同理：需要Default和Even各指向一个Part。这里有个细节容易被忽略：Odd没有专门的引用类型，奇数页的页脚就是Default。而当你同时设置首页不同和奇偶页不同时，Page 1属于“First”，Page 2属于“Even”，Page 3及以上奇数页才用Default。
给段代码演示一下如何添加首页页脚：
static void AddFirstPageFooter(string filePath) { using var doc = WordprocessingDocument.Open(filePath, true); var mainPart = doc.MainDocumentPart!; var body = mainPart.Document.Body!; var firstPart = mainPart.AddNewPart<FooterPart>(); var firstFooter = new Footer(); firstFooter.Append(new Paragraph(new Run(new Text("内部资料，请勿外传")))); firstPart.Footer = firstFooter; firstPart.Footer.Save(); var sectPr = body.Elements<SectionProperties>().First(); // 删除同类型的旧引用，防止重复 sectPr.Elements<FooterReference>() .Where(f => f.Type?.Value == HeaderFooterValues.First) .ToList() .ForEach(f => f.Remove()); sectPr.Append(new FooterReference() { Type = HeaderFooterValues.First, Id = mainPart.GetIdOfPart(firstPart) }); mainPart.Document.Save(); }在删除旧引用时，只删同类型的这个细节很关键。如果你粗心地把所有FooterReference都删了，Default页脚也没了，文档可能直接变成一个“没有页脚”的状态，用户反馈说“页脚怎么没了”，十有八九是这里操作过猛。
5. 实战排查：页脚没显示、页码不刷新、引用错乱的问题清单
5.1 页脚内容存了但Word里看不到——没触发保存链路
这大概是所有OpenXML操作里最常见的问题：代码里明明写了footerPart.Footer.Save()，也调了mainPart.Document.Save()，可文档打开后页脚就是空的。
排查思路是这样：先确认FooterPart是不是真的存在。用解压工具查看word目录下有没有footer1.xml这类文件。如果有，检查footer1.xml里是不是真的写了段落和Run；如果文件都没有，说明问题出在前期创建Part的环节。如果文件有内容但页面不显示，那就要看FooterReference有没有挂上，以及挂上的r:id是否指向了正确文件。
还有一种隐蔽情况：你改了内容，改了保存，但当时的Word进程还把文档打开着，读写时没释放文件句柄。OpenXML对这种情况不做任何提示，数据写出去后又被Word的缓存覆盖，等到你下次打开才发现是旧内容。遇到“保存了不生效”，第一反应先关掉所有打开的Word窗口，再重跑一次。
5.2 多页文档页码全都是1——字段缓存和刷新问题
打开文档发现每一页的页码都显示“1”，这个现象的原因是FldSimple里写的那个缓存值本身就是1，Word打开时按“不更新字段”的默认策略处理了。不更新不是Word的bug，是有意为之——更新的动作有风险（比如公式域、交叉引用域可能被重新计算），Word默认是保守策略。
解决办法有几种。一种是写完之后用OpenXML手动把缓存值改成正确页码，但这需要遍历所有节、统计页数，成本很高而且容易算错。更稳的做法是复用Word内置的更新策略：在DocumentSettings里加一个UpdateFieldsOnOpen设置，让Word在打开时自动更新所有字段。
var settings = mainPart.DocumentSettingsPart!.Settings; var updateFields = new UpdateFieldsOnOpen() { Val = OnOffValue.FromBoolean(true) }; settings.Append(updateFields); settings.Save();这个做法简单有效，唯一的注意点是它会让所有字段在每次打开时都更新，如果你文档里还有其他性能敏感的字段（比如大量交叉引用），打开速度会稍微变慢。对于常规标书、合同这类文档，完全在可接受范围内。
5.3 多个小节页脚互相“串门”——引用了同一个Part
“第一节改了页脚，第五节也变”这种情况，十有八九是多节共享了同一个FooterPart。如果这种共享不是你刻意为之的，你需要把“共享Part变成独立Part”。
具体操作是：对每个需要独立页脚的节，新建一个FooterPart并复制原Part的内容，然后修改该节的FooterReference去指向新的Part。注意复制内容时用footer.OuterXml直接拷贝根元素，简单又不会遗漏任何嵌套子节点。
如果反过来，你想要的效果就是“全文档统一页脚”，那可以让所有节指向同一个PartId。这种情况下，只要改这一个Part，全文档刷新，反而省心。判断一次要解决的场景需求，再来决定用共享还是独立Part，能少写一半的找错代码。
5.4 页脚里插的图片显示异常
页脚里加Logo是个常见需求，但OpenXML里在页脚放图片比正文稍微绕一点：必须先给FooterPart添加ImagePart类型的子Part，再通过绘图（Drawing）结构引用它。这里面的引用关系又深一层，常见的报错是“图片所在的Part已经在别处引用过”或“绘图里的rId找不到目标”。
我的建议是，如果页脚里的图片不是核心需求，优先用“页脚加公司名+页码”这种纯文本方案，稳定、跨版本兼容性好。图片页脚请单独开一讲来演示，因为涉及Extent、DocProperties、BlipFill等多个绘图层级的元素，很容易在坐标和大小上反复试错。
6. 个人经验：页脚操作要少踩的几个坑
最后再把这一年多跟页脚死磕的经验做个总结，都是踩完之后才彻底想明白的：
第一，操作页脚前，一定先想清楚“这个页脚要作用于哪几个节”。OpenXML的节和Part引用关系不像Word界面那么直观，界面上你看到的是“当前节”，底层却是多个FooterReference共享Part。动手前用代码打印一遍所有节的FooterReference清单，能把后面大半的问题消灭在源头。
第二，FldSimple的缓存值“1”不是bug，不要浪费时间去手工改。真正的解法是更新字段设置，或者告诉用户在Word里按Ctrl+A再按F9手动刷新。做SDK开发时，能交给Word自己算的就别自己算，稳定性比“看起来代码很聪明”重要得多。
第三，页脚的Part生命周期管理要克制。SDK不会帮你自动清理失去引用的FooterPart，你删了引用但留在包里的Part，不会影响显示，但会白白增大文件体积。留着也就留着，非要清理的话，记得先确认没有任何节点还引用它，再调用MainDocumentPart.DeleteParts。
对系列教程来说，页脚讲完之后，Word文档结构里的“边角料”就剩页眉还没系统提了。页眉和页脚的数据模型几乎完全对称，本讲里讲的Part共享、三类型引用、字段刷新策略，套到页眉上一样成立。建议你把页脚的例子亲手跑一遍，再照着把页眉的功能也写一份，底层逻辑打通之后，后面再做奇偶页不同的复杂版式，就不需要再翻文档了。
