做办公自动化这行当久了,你会发现一个规律:文档生成流程里最容易翻车的,恰恰是大家觉得最“不起眼”的页眉页脚。正文无非是文字、图片、表格往页面里堆,可页眉页脚牵扯到分节机制、首页不同、奇偶页不同、页码域、链接到上一节这些规则,任何一个环节理解偏了,生成出来的Word就会带着肉眼可见的瑕疵。这篇教程就围绕.NET环境下用Spire.Doc操作Word页眉页脚这个主题,把我实际踩过的坑、验证过的写法、批量生成场景里的处理思路完整梳理一遍,给准备做办公自动化的朋友一份能直接参考的实战笔记。1. 为什么页眉页脚值得单独拆出来写一篇很多教程会把页眉页脚当成Word操作里的一个“小功能”,三言两语带过,然后给个示例代码就完事。但真到了真实业务里,页眉页脚往往是工作量最集中、返工率最高的部分。我先把最常见的几类场景摆出来,你看完就明白为什么值得单独研究。1.1 办公文档里最常见的三类页眉页脚需求第一类是投标书、合同、标书类的正式文档。这类文档通常要求首页或封面不显示页眉页脚,从正文开始出现公司Logo、公司名称,页脚还要带上“第X页 共Y页”的页码格式。更麻烦的是,不同章节可能还需要不同的页眉文字,比如第一章写“技术方案”,第二章写“项目管理”,中间可能还要插一张纯横向的表格页。第二类是论文、书籍类的排版需求。封面、摘要、目录、正文分别用不同样式的页眉,页脚还需要从某一页重新编号,奇偶页页眉还要求一个靠左一个靠右。这类需求在Word里手工操作已经很繁琐了,一旦数据变了要重新生成,手工流程基本不可维护。第三类是批量出证场景。我做过一个批量生成培训证书的项目,一次要生成几千份文档,每份页眉都要带不同的客户名称和编号,页脚要有统一的页码。这种情况下,手工点击“插入页眉”完全不现实,唯一的出路就是把页眉页脚的动态部分交给代码去处理。这三类需求都有共同特点:规则多、样式杂、状态敏感。它们恰恰是代码实现最容易出错的地方。1.2 手动设置与代码设置的本质差异手动在Word里操作页眉,你看到的是“当前这一页”的显示效果:加文字、调字体、拖动位置,所见即所得。但代码操作面对的不是“页面”,而是文档内部的数字化结构。在Word的底层模型里,页眉页脚不属于“页面”,而属于“节”。一个文档可以有若干个节,每个节都可以有自己的页眉页脚。你手动删除一条页眉横线,实际是在修改该段落的下边框;你手动勾选“首页不同”,实际是启用了一个叫FirstPageHeader的独立页眉区域。这些底层概念,手动操作时Word帮你隐藏了,写代码时却必须一清二楚。另外,手动操作可以随意拖动页眉位置,代码操作却只能通过页眉区域内的段落对齐方式、页边距和HeaderDistance这几个参数来间接控制位置。理解不了这层差异,写代码时就容易陷入“为什么我无论怎么设置文字都不居中”“为什么页眉和正文叠在一起”这类困惑。2. 组件选型:Spire.Doc是怎么进入我的项目的做.NET平台下的Word生成,方案其实不少。我在不同项目里分别试过OpenXML SDK、COM Interop和Spire.Doc,最后在需要频繁处理页眉页脚的项目里,基本都用了Spire.Doc。这里把选型过程摊开讲,方便你根据自己的场景判断。2.1 OpenXML SDK、COM Interop、Spire.Doc三方对比OpenXML SDK是微软官方的免费方案,本质是让你直接操作docx文件的XML结构。理论上它能做所有事情,但代价是心智负担极高。一个页眉页脚牵扯到headerReference、sectPr、headerPart、footerPart等多个节点的关联,你不仅要懂Word的业务模型,还得懂OpenXML的XML语法。我做了一个简单的页眉设置,写了两百多行XML操作代码,维护成本实在太高。COM Interop是通过Word应用程序对象来操作文档,功能最全,和手动操作几乎一致。但它的致命问题在于:目标机器必须安装Word,服务端部署时对Office版本极其敏感,并发调用还容易出现“服务器正在处理另一个请求”这类错误。微软官方也不建议在服务端使用COM组件。小规模自动化可以,批量生产场景我是不敢用。Spire.Doc是收费商业组件,但有免费版可以评估。它的API设计贴近Word对象模型,比如section.HeadersFooters.Header这种写法,熟悉Word的人基本一看就懂,把OpenXML需要写两百行的操作压缩成了十几行。支持.NET Framework和.NET Core/.NET 5,还能直接导出PDF,整体比较适合办公自动化项目。下表是我当时的横向对比:对比维度OpenXML SDKCOM InteropSpire.Doc上手成本高,需理解XML结构低,贴近Word操作低,贴近Word对象模型部署依赖无必须安装Office无服务端并发支持易冲突支持页眉页脚API需手动拼接XML全功能但依赖Word专用对象模型,简洁费用免费免费商业授权,免费版有段落限制导出PDF需另做转换可用Word导出内置支持2.2 NuGet引入与版本选择引入方式很简单,Visual Studio里用NuGet包管理器搜索Spire.Doc,或者用命令行:dotnet add package Spire.Doc版本选择上我的建议是:不要盲目追求最新,锁定一个稳定版本,团队统一使用。Spire.Doc的API在不同小版本之间基本稳定,但偶尔会有命名空间调整或枚举改名。我曾经在升级版本后遇到过BorderStyle枚举编译不过的情况,排查了半天发现是命名空间From/To的变动。项目一旦跑起来,除非有明确的新功能需求,否则不要随意升级。2.3 免费版限制与License加载Spire.Doc免费版有两个硬限制:文档最多500个段落、最多25个表格。注意,页眉页脚里的段落同样计算在内,因为页眉本质也是Paragraph。很多开发者在开发阶段测试小文档一切正常,一上真实数据就发现文档“被截断”,其实是免费版限制在起作用,不是代码逻辑问题。如果只是个人学习、内部工具或者数据量确实很小,免费版够用。商用项目建议申请License,加载方式也很常规:using Spire.License; LicenseProvider.SetLicenseFileName(license.elic);把license.elic放到程序输出目录,在创建Document之前调用一次即可。具体文件名和申请流程以官方渠道为准,但整体思路就是这样。注意:License加载必须在创建Document对象之前执行。放到后面调用,在某些版本里不会报错,但限制可能依然生效。2.4 最小可运行示例上手阶段别贪多,先跑通一个最小示例:新建文档,设置一段页眉文字,保存。下面这段代码就是我推荐的第一课。using Spire.Doc; using Spire.Doc.Documents; using System.Drawing; Document doc new Document(); // new Document()自带一个Section,直接取用即可 Section section doc.Sections[0]; HeaderFooter header section.HeadersFooters.Header; // 页眉默认有一个空段落,优先取第一个段落,避免多出空行 Paragraph headerPara header.Paragraphs.Count 0 ? header.Paragraphs[0] : header.AddParagraph(); headerPara.AppendText(内部资料,请勿外传); doc.SaveToFile(demo.docx, FileFormat.Docx2013);跑通这个示例后,再往里面加字体设置、对齐方式、页码域等内容。页眉页脚的学习一定要从最小示例开始,不要在第一次写代码时就塞入首页不同、奇偶页不同这些复杂条件,否则出了问题都不知道是哪一步引入的。3. 对象模型:页眉页脚到底挂在哪个对象上写Spire.Doc代码之前,必须先搞清楚它的对象层级。页眉页脚不是挂在Document上的,而是挂在Section上的,这是整个章节最核心的认知。3.1 Document、Section、HeadersFooters、Paragraph的关系一个Word文档由多个节组成,每个节有自己的页面设置、页边距、页眉页脚。代码里的访问路径是:Document → SectionCollection → Section → HeadersFooters → HeaderFooter → ParagraphCollection → Paragraph所有页眉页脚的内容操作,最终都落在Paragraph上。你往页眉里添加文字,操作的是Paragraph.AppendText;添加图片,操作的是Paragraph.AppendPicture;添加页码域,操作的是Paragraph.AppendField。搞清楚这条链路后,遇到任何需求都能顺着路径找到对应的属性。拿上一章的示例来说,doc.Sections[0]拿到第一节,section.HeadersFooters.Header拿到默认页眉,header.Paragraphs[0]拿到页眉里的段落。这个三段式的目光顺序,就是页眉页脚代码的标准姿势。3.2 HeaderFooter的三种身份Spire.Doc里,HeaderFooter不是只有一个。根据Word的排版规则,页眉页脚可以分成三种身份:HeaderFooterTypeWord中的对应区域何时生效Header / Footer默认的页眉和页脚未启用首页不同和奇偶页不同时FirstPageHeader / FirstPageFooter首页的页眉和页脚启用了DifferentFirstPageHeaderFooter时EvenPageHeader / EvenPageFooter偶数页的页眉和页脚启用了OddAndEvenPagesHeaderFooter时默认情况下,文档只使用Header和Footer这两个区域。一旦你设置了section.PageSetup.DifferentFirstPageHeaderFooter true,首页的内容就要写到FirstPageHeader,否则首页会用默认页眉。一旦设置了OddAndEvenPagesHeaderFooter true,偶数页的内容要写到EvenPageHeader,默认的Header就变成“奇数页页眉”了。这个变化是很多新手困惑的根源。我见过不少人在启用“首页不同”之后,依然往Header里塞内容,结果封面页就是不出页码,还以为是代码没生效。3.3 IsLinkedToPrevious:页眉的继承链这是页眉页脚里最隐蔽、也最容易坑人的属性。Word文档的多个节之间,默认存在一种“链接到上一节”的关系,也就是后面一节的页眉页脚复用前一节的设置。在Spire.Doc里,对应属性就是HeaderFooter.IsLinkedToPrevious。当一个节的页眉IsLinkedToPrevious为true时,你修改这个节的页眉,实际上改的是它链接的那个上一节页眉。反之,你想让每个章节拥有不同的页眉,就必须先把IsLinkedToPrevious设置为false,再修改该节自己的页眉。我总结过一条排查规律:任何“我改了第二节,第一节也变”“改了第一节,后面全变”的诡异现象,十有八九都是IsLinkedToPrevious引起的。处理多节页眉的时候,第一件事就是把每个节的链接状态遍历打印出来,再动手改内容。4. 基础实操:文本页眉和“第X页 共Y页”页脚理论知识铺垫到位后,直接看完整示例。这一章的代码基本覆盖了日常80%的页眉页脚需求,建议手打一遍而不是复制粘贴,打代码的过程也是熟悉API的过程。4.1 写入文本页眉并设置字体先写页眉部分。需求很常见:一段文字居中显示,字体偏小、颜色偏灰,符合正式文档的观感。using Spire.Doc; using Spire.Doc.Documents; using System.Drawing; Document doc new Document(); Section section doc.Sections[0]; // 获取默认页眉 HeaderFooter header section.HeadersFooters.Header; // 页眉自带一个空段落,尽量复用,避免多余空行 Paragraph headerPara header.Paragraphs.Count 0 ? header.Paragraphs[0] : header.AddParagraph(); headerPara.Format.HorizontalAlignment HorizontalAlignment.Center; TextRange range headerPara.AppendText(XX科技有限公司投标文件); range.CharacterFormat.FontName 微软雅黑; range.CharacterFormat.FontSize 9f; range.CharacterFormat.TextColor Color.DimGray;这里有几个关键点。AppendText返回的是一个TextRange对象,所有字体相关的设置都要通过TextRange.CharacterFormat来做。如果你的代码里只调用了AppendText没接收返回值,后续想设置字体就得回过头改结构,所以最好一开始就把返回值接住。还有一个经常被忽略的问题:页眉区域自带一个空段落,如果不管它,直接调用header.AddParagraph(),结果就是页眉里出现两个段落,文档打开后页眉区域多出一行空行,高度和位置全会乱掉。我现在的习惯是统一用Paragraphs[0],只有当集合为空时才AddParagraph。4.2 页脚页码:为什么必须用域而不是硬编码页脚部分的需求通常是“第X页 共Y页”。很多人第一次写会想:先数一下文档有多少页,然后把数字写进页脚。这个思路在Word里是大忌。原因很简单:文档的分页不是静态的。读者用不同版本的Word打开,字体缺失、打印设置变化、页面大小调整,都会导致重新分页。如果页码是硬编码进去的数字,分页一变,页码就错了。所以Word提供了“域”机制,让页码在每次刷新时自动计算。Spire.Doc里插入页码域的代码非常直观:HeaderFooter footer section.HeadersFooters.Footer; Paragraph footerPara footer.Paragraphs.Count 0 ? footer.Paragraphs[0] : footer.AddParagraph(); footerPara.Format.HorizontalAlignment HorizontalAlignment.Center; footerPara.AppendText(第 ); footerPara.AppendField(Page, FieldType.FieldPage); footerPara.AppendText( 页,共 ); footerPara.AppendField(Pages, FieldType.FieldNumPages); footerPara.AppendText( 页);AppendField的第一个参数是域的名称,可以随便起,但建议语义化;第二个参数是域类型,FieldPage表示当前页码,FieldNumPages表示总页数。保存为docx后,Word打开时会自动刷新域,显示真实的页码数字。除了一页共几页,常用的域类型还有这些:字段类型作用典型场景FieldPage当前页码页脚页码FieldNumPages文档总页数页脚“共Y页”FieldSection当前节号多章节文档FieldSectionPages当前节的总页数“本章共Y页”FieldFileName文件名称页眉显示文档名FieldDate当前日期合同签署日期在保存为PDF之前,建议先调用doc.UpdateFields()刷新一次域,确保导出PDF时显示的是正确的计算结果,而不是未计算的占位符。4.3 页眉横线的添加与删除页眉里那条细细的横线,很多人以为是Word自动画的装饰线,实际上它是页眉段落的下边框。理解了这个本质,才能用代码控制它。添加一条页眉横线:// 在页眉段落的底部加单线边框 headerPara.Format.Borders.Bottom.BorderType BorderStyle.Single;删除这条默认横线:headerPara.Format.Borders.Bottom.BorderType BorderStyle.None;注意这里的枚举值在不同小版本里写法可能略有差异,以你引用版本的智能提示为准。但思路是固定的:横线是段落边框,不是独立对象。你在Spire.Doc里是找不到所谓“HeaderLine”之类的对象的。这里额外说一句,不少人在网上找删除页眉横线的代码,看到的是先新建一个样式,清空原有样式,再手动设置边框。这套做法本质是绕开文档自带的Header内置样式。但多数场景下,直接用BorderStyle.None处理段落下边框就够了,不需要那么复杂。5. 进阶场景:封面无页眉、奇偶页不同、批量Logo页眉基础示例跑通后,再看真实项目里高频出现的三个进阶场景。这三个场景单独看都不难,但组合起来会考验你对分节机制的理解。5.1 封面不要页眉页脚,正文重新编页码最经典的需求:第一页是封面,封面不能有页眉页脚;从第二页开始,正文页眉显示公司信息,页码从1开始编。实现思路是分两个节。第一节只放封面内容,第二节放正文。页眉页脚按节隔离,第一节页眉留空,第二节页眉正常设置,同时让第二节重新开始页码。Document doc new Document(); Section coverSection doc.Sections[0]; Section bodySection doc.AddSection(); // 封面节:页眉清空 HeaderFooter coverHeader coverSection.HeadersFooters.Header; coverHeader.Paragraphs.Clear(); HeaderFooter coverFooter coverSection.HeadersFooters.Footer; coverFooter.Paragraphs.Clear(); // 正文节:断开与封面的页眉链接 HeaderFooter bodyHeader bodySection.HeadersFooters.Header; bodyHeader.IsLinkedToPrevious false; Paragraph bodyHeaderPara bodyHeader.Paragraphs.Count 0 ? bodyHeader.Paragraphs[0] : bodyHeader.AddParagraph(); bodyHeaderPara.AppendText(正文页眉); // 正文节:重新从1开始编号 bodySection.PageSetup.RestartPageNumbering true; bodySection.PageSetup.PageNumber 1; doc.SaveToFile(contract.docx, FileFormat.Docx2013);关键点有两个。一个是IsLinkedToPrevious必须设为false,否则你修改正文页眉,封面页眉也跟着变,因为Word默认是“链接到上一节”。另一个是RestartPageNumbering和PageNumber这两个属性,前者告诉Word“页码重新开始计”,后者指定从哪个数字开始。设置后,正文的物理页码可能从第2页开始,但显示的页码会从1开始。提示:封面页眉清空用的是Paragraphs.Clear(),这会把页眉里的内容全部移除。如果执行后页眉区域仍然出现一条横线,用第4.3节的方法把段落下边框也一并设为BorderStyle.None。5.2 奇偶页页眉:图书排版的左右页规则论文、书籍、双面打印的报告,常要求奇数页页眉靠右,偶数页页眉靠左。Spire.Doc开启这个能力是一行代码的事:section.PageSetup.OddAndEvenPagesHeaderFooter true;开启后,默认的Header代表奇数页页眉,偶数页内容需要写到EvenPageHeader:// 奇数页页眉:靠右 HeaderFooter oddHeader section.HeadersFooters.Header; Paragraph oddPara oddHeader.Paragraphs.Count 0 ? oddHeader.Paragraphs[0] : oddHeader.AddParagraph(); oddPara.Format.HorizontalAlignment HorizontalAlignment.Right; oddPara.AppendText(第 1 章 项目概述); // 偶数页页眉:靠左 HeaderFooter evenHeader section.HeadersFooters.EvenPageHeader; Paragraph evenPara evenHeader.Paragraphs.Count 0 ? evenHeader.Paragraphs[0] : evenHeader.AddParagraph(); evenPara.Format.HorizontalAlignment HorizontalAlignment.Left; evenPara.AppendText(XX项目技术方案);这里有一个容易忽略的点:开启奇偶页不同之后,默认Header的文字在奇数页显示,偶数页如果没设置EvenPageHeader,偶数页的页眉就是空的。你需要在两个区域分别写入内容。另外,首页是“第1页”,通常属于奇数页,如果你想单独控制封面页眉,还要配合DifferentFirstPageHeaderFooter来设置FirstPageHeader。5.3 批量生成场景:Logo页眉加动态客户文本批量生成是办公自动化的核心价值所在。举个例子,我要给一批客户生成受理通知单,每份文档页眉都要有公司Logo、客户名称,页脚有页码。实现时注意性能问题:循环内反复加载图片资源会拖慢速度,应该把Logo图片对象在循环外只加载一次。using Spire.Doc; using Spire.Doc.Documents; using Spire.Doc.Fields; using System.Drawing; using System.IO; ListCustomerInfo customerList GetCustomerList(); Image logo Image.FromFile(C:/resources/logo.png); foreach (CustomerInfo customer in customerList) { using (Document doc new Document()) { Section section doc.Sections[0]; HeaderFooter header section.HeadersFooters.Header; Paragraph headerPara header.Paragraphs.Count 0 ? header.Paragraphs[0] : header.AddParagraph(); // 页眉左部放Logo Paragraph logoPara header.AddParagraph(); DocPicture picture logoPara.AppendPicture(logo); picture.Width 40f; picture.Height 15f; // 页眉右部放客户名称 Paragraph namePara header.AddParagraph(); namePara.AppendText(客户名称: customer.Name); // 页脚统一页码 HeaderFooter footer section.HeadersFooters.Footer; Paragraph footerPara footer.Paragraphs.Count 0 ? footer.Paragraphs[0] : footer.AddParagraph(); footerPara.AppendField(Page, FieldType.FieldPage); doc.SaveToFile($C:/output/{customer.Id}.docx, FileFormat.Docx2013); } } logo.Dispose();这里用了多个Paragraph来组织页眉内容,因为Word页眉区域本身可以承载多段文本,每个Paragraph可以通过HorizontalAlignment设置独立对齐方式,比用一个Paragraph拼空格要稳得多。用空格硬调排版,字体一变、标点一变,位置就废了。还有一点,批量生成标题文档时,每份文档都从零开始AddParagraph,会快速消耗免费版的段落配额。如果配额紧张,优先考虑第7章说的模板方案。6. 实战避坑:四个让我熬夜排查的页眉页脚问题这部分内容来自实际项目里的血泪教训。我按“现象→原因→解决方案”的结构写,你遇到同类问题时可以直接对照排查。6.1 页眉横线删不掉的真正原因现象:用Spire.Doc设置页眉文字后,Word打开出现一条横线,用代码把Borders.Bottom设为None,横线还在。原因:这条横线不是单纯某个段落的边框,而是文档内置的Header样式自带的边框。你手动往页眉里加了一个新段落,新段落没有继承横线,但原始段落还留着样式边框,横线自然还在。排查思路:先看当前页眉有多少个段落。如果Paragraphs.Count大于1,很可能文字写在了新段落里,老段落带着边框横线还在原位。解决方案是双管齐下:先把老段落清空,再给保留下来的段落设置边框。HeaderFooter header section.HeadersFooters.Header; if (header.Paragraphs.Count 1) { header.Paragraphs.RemoveAt(0); } Paragraph headerPara headerParagraphs[0]; headerPara.Format.Borders.Bottom.BorderType BorderStyle.None; headerPara.AppendText(新的页眉文字);你要明白一件事:删除横线不是删一条线,而是删掉“带着边框的段落”。这也是为什么我一直强调复用Paragraphs[0],而不是随手AddParagraph的原因。6.2 改了某一节,整篇的页眉全都跟着变现象:文档有五个节,我只想改第三节的页眉。运行代码后,Word打开发现第二节、第四节、第五节,甚至第一节的页眉都变了。原因:后面三个节默认IsLinkedToPrevious为true,一改第三节,第四节、第五节跟着同步。如果整篇页眉一开始就是同一个来源,第一节和第二节也可能受影响。排查链路:第一步,遍历所有节,打印每个节页眉的IsLinkedToPrevious状态;第二步,找到需要独立的那一节,设为false;第三步,修改它自己的内容;第四步,检查它后面的节是否也需要同步变化,如果不需要,按顺序逐个断开。for (int i 0; i doc.Sections.Count; i) { bool linked doc.Sections[i].HeadersFooters.Header.IsLinkedToPrevious; Console.WriteLine($Section {i} IsLinkedToPrevious {linked}); }这个问题的隐蔽之处在于,代码不报错,表面上每一节都有独立操作对象,但实际效果就像被一根绳子串起来一样。不打印状态,光看代码很难发现联系。6.3 页眉文字被截断、位置偏移现象:页眉内容比较多,生成后打开Word,页眉区显示不全,或者页眉离正文太近,看起来挤在一起。原因:页眉区域的高度和位置受两个参数控制:HeaderDistance(页眉距离页面顶部的距离)和TopMargin(页眉距离正文起始位置的距离)。页眉内容越多,需要的空间越大,默认的HeaderDistance就不够用了。处理方式很直接:// 调大页眉距离页面顶部的距离 section.PageSetup.HeaderDistance 30f;还有一个容易被忽略的因素:页眉图片太大。图片的原始尺寸可能远超页眉可用区域,尤其是直接从相机、设计稿里拿来的Logo图。正确做法是插入前先设定DocPicture的Width和Height,把图片约束在一个合理范围内,比如高度控制在15f左右。图片超宽导致页眉行高被撑大,也会影响整个版式。6.4 免费版“半路截断”问题现象:测试时文档一切正常,换真实数据后,保存的Word打开只显示前半部分,后面的内容丢失。原因:极大概率是免费版500段落限制被触发,而且这个截断是静默发生的,代码不报异常,只有打开保存的文件才能发现。处理路径有三条。一是优化代码结构,尽量复用已有段落,而不是反复AddParagraph;二是模板化,用第7章的方案把静态内容放模板里,代码只做替换;三是购买License。我的自查习惯是:每次跑批量任务前,写一个计数器,统计整个文档创建了多少个Paragraph和Table,一旦接近500就及时调整方案,别等输出到了用户手上才暴露问题。7. 模板化工作流:把页眉页脚的复杂度降一半如果你刚看完前面几章,觉得API虽然不难,但组合起来还是很繁琐,那我的建议是:换一条路,用模板。7.1 用Word做模板,Spire.Doc只做“填空”页眉页脚最大的痛点不是代码难度,而是细节太多。字体、间距、边框、图片位置,这些纯样式的东西在代码里反复调参,效率极低。我的常规做法是:先用Word或WPS手工做一个模板文件,把页眉Logo、公司名称、页脚页码、样式、分节、首页不同这些一次性调好。模板里需要动态变化的地方用占位符标出,比如【客户名称】、【项目编号】。然后Spire.Doc只做两件事:加载模板,替换占位符。Document doc new Document(); doc.LoadFromFile(C:/templates/notice_template.docx); doc.FindAndReplace(【客户名称】, customer.Name, true, true); doc.FindAndReplace(【项目编号】, customer.ProjectId, true, true); doc.SaveToFile(output.docx, FileFormat.Docx2013);这个工作流的好处是:页眉页脚的样式所见即所得,在Word里预览什么效果,生成出来就是什么效果。代码里不再出现任何字体设置、边框枚举、段落对齐之类的逻辑,出错面大幅缩小。如果模板里要保留一个Logo图片,替换流程会稍微多一步,先用书签定位图片占位,再通过AppendPicture替换。但绝大多数文案类占位符场景,FindAndReplace就够用了。7.2 输出PDF时的页眉页脚渲染注意模板方案里,经常需要把最终文档导出成PDF。Spire.Doc的SaveToFile可以直接输出PDF:doc.SaveToFile(output.pdf, FileFormat.PDF);此时页眉页脚里的内容会被一并渲染。有几个细节需要关注:一是保存前记得调用doc.UpdateFields(),刷新页码域,否则PDF里可能出现未计算的域代码;二是插入的Logo图片尽量用PNG格式,避免JPG压缩导致的锯齿;三是图片尺寸要在插入前控制好,别让一张原始200mm宽的设计图直接塞进页眉,这样会把整个页眉区撑变形。我的经验是:模板方案加PDF输出的组合,让页眉页脚的代码量减少六成以上,而且成果稳定。这也是为什么我在做正式项目时,首选模板,而不是完全靠代码构建一切。最后说个我自己的习惯:凡是页眉页脚逻辑复杂的项目,我一定先用Word手工搭一版模板再交给代码处理。这不是不信任Spire.Doc的能力,而是知道自己的精力应该花在哪里。把样式问题交给Word,把数据问题交给代码,分工明确,文档质量反而最高。