这一讲我们来看页脚。说实话在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.xmlDocument └── Body └── sectPr节属性 └── FooterReferencer:id 指向某个FooterPart └── FooterPart └── Footer根元素 └── Paragraph / Run / Text每个Section可以引用三种不同的页脚分别对应三种查看场景默认页脚、首页页脚、偶数页页脚。一个节最多挂三个FooterReference分别通过Type属性区分。还有一个容易忽略的点多个Section可以引用同一个FooterPart。Word默认新建文档的所有节共用同一份页脚内容这个“共用关系”在底层就是多个sectPr里的FooterReference指向同一个Part Id。搞清楚这点后面调试“改了一节、全文档都变”的问题就有了方向。1.2 页脚的三种类型编码default、first、evenFooterReference的Type属性来自HeaderFooterValues枚举取值有三个枚举值对应场景说明Default默认页脚所有页面使用除非命中了First或Even的规则First首页页脚仅文档或节的首页显示Even偶数页页脚设置“奇偶页不同”后偶数页显示的页脚这里面的优先级很容易踩坑。很多人以为First和Even是“额外页脚”其实它们是“覆盖规则”当某一页同时命中了首页和偶数页两个条件时Word内部有一条明确的优先级顺序——首页优先于偶数页且首页页脚只对节内第一页生效。另外如果你在Word界面里勾选了“首页不同”系统会自动在当前节的sectPr里插入一个TypeFirst的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?.ElementsSectionProperties().FirstOrDefault(); if (firstSection null) return; var refElement firstSection.ElementsFooterReference() .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.ElementsParagraph()) { var text string.Concat(para.DescendantsText().Select(t t.Text)); System.Console.WriteLine(text); } }这里有个值得说透的细节Paragraph里的文字不只在Text元素里还有可能是FieldCode、InstrText、DeletedText等。用Descendants()可以拿到所有嵌套层级的文本节点比直接访问Paragraph.InnerText更精准。如果页脚里插了页码字段你会看到PAGE字段本身不是文本它显示的值是Word每次打开文档时计算出来的所以读取时只能拿到PAGE这个字段指令拿不到真实页码数字——这是正常现象。读取过程中的另一个关键点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.AddNewPartFooterPart(); 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.ElementsSectionProperties().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创建了一个FooterPartSDK自动分配一个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.AddNewPartFooterPart(); var firstFooter new Footer(); firstFooter.Append(new Paragraph(new Run(new Text(内部资料请勿外传)))); firstPart.Footer firstFooter; firstPart.Footer.Save(); var sectPr body.ElementsSectionProperties().First(); // 删除同类型的旧引用防止重复 sectPr.ElementsFooterReference() .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里写的那个缓存值本身就是1Word打开时按“不更新字段”的默认策略处理了。不更新不是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里按CtrlA再按F9手动刷新。做SDK开发时能交给Word自己算的就别自己算稳定性比“看起来代码很聪明”重要得多。第三页脚的Part生命周期管理要克制。SDK不会帮你自动清理失去引用的FooterPart你删了引用但留在包里的Part不会影响显示但会白白增大文件体积。留着也就留着非要清理的话记得先确认没有任何节点还引用它再调用MainDocumentPart.DeleteParts。对系列教程来说页脚讲完之后Word文档结构里的“边角料”就剩页眉还没系统提了。页眉和页脚的数据模型几乎完全对称本讲里讲的Part共享、三类型引用、字段刷新策略套到页眉上一样成立。建议你把页脚的例子亲手跑一遍再照着把页眉的功能也写一份底层逻辑打通之后后面再做奇偶页不同的复杂版式就不需要再翻文档了。