简介面向C#开发人员的Open XML生成PPT示例资源。它通过一个完整的WinForms工程演示了如何使用DocumentFormat.OpenXml包来动态创建PowerPoint文件从创建PresentationDocument、添加SlideMaster与SlideLayout再到构建Slide并插入标题、文本框等内容均覆盖到位适合自动化报表、数据可视化或教学材料制作等场景对需要脱离PowerPoint程序批量生成PPT的开发者尤其友好。资源共63个文件以cs源码、dll依赖、json配置文件为主同时包含工程文件、解决方案、演示截图以及依赖的OpenXml程序集等压缩包大小仅2.43MB目录结构清楚便于对照学习。已有287人前来学习下载项目层次简洁参考其代码可显著降低Open XML SDK的上手门槛。 做自动化办公这块很多人一听“用代码生成PPT”就觉得头大觉得非得装Office、用COM组件操作PowerPoint才行。其实真跑过一阵之后你会发现最稳定、最可控的方案反而是直接去读写PPTX文件底层的XML也就是标题里写的C#配Open XML SDK。我最近接了个需求要定期根据数据库数据生成几十份带图表的客户汇报PPT自从换成这套方案服务端不用再装Office速度也从原来COM方式的一页两三秒提升到毫秒级。这篇文章就完整记录一下我的实现思路、核心代码和踩过的坑。我先说个基本认知一个 .pptx 文件本质上就是个zip压缩包里面是一堆XML文档和媒体资源。只要能理解这层结构用C#操作PPT就跟读写普通XML一样简单。而且Open XML SDK是微软官方维护的库跨平台、开源、无需安装Office特别适合做服务端批量生成。1. 为什么非要折腾Open XML去碰PPT1.1 PPTX本质就是个zip文件我第一次知道PPTX是zip的时候也挺惊讶的。你随便复制一份pptx把后缀改成.zip解压开就能看到里面一整套目录结构。所有版式、文本、图片、主题全部以XML文件的形式躺在里面。PowerPoint打开文件时就是读取这些XML并按规则渲染。所以“用Open XML生成PPT”这个命题本质上就是“用代码生成一段符合Office Open XML规范的XML文档”。听起来比COM调用PowerPoint复杂但你想想这等于把PowerPoint这个重量级依赖从你的程序里彻底拿掉了。程序可以跑在Linux服务器上跑在Docker容器里跑在根本没有图形界面的机器上。1.2 三种生成方式我怎么选我自己把市面上常见的方式整理过一遍大概分三类方案优点缺点COM组件Interop.PowerPoint上手快功能全必须装Office服务端容易弹出隐藏窗口并发差速度慢Open XML SDK无需Office跨平台速度快适合批量需要理解文件结构学习曲线略陡第三方库Aspose等API封装友好大多商业授权价格不便宜COM方案我最早试过功能确实全但稳定性一言难尽。跑到一半弹出“程序无响应”的对话框无人值守的定时任务就卡死了。Open XML方案就没有这个烦恼你只是往zip包里写XML不涉及任何进程调度。1.3 Open XML SDK到底解决什么问题Open XML SDK是微软官方出的.NET库NuGet包名就叫DocumentFormat.OpenXml。它把OOXML规范里那些繁琐的XML节点封装成了强类型类。比如文本是A.Text形状是P.Shape图片是P.Picture你不需要手写XML字符串代码里new对象就行。它对开发者的实际意义是能对PPT文件进行精确到每一个元素级别的读写。既可以打开已有文件做模板替换也可以完全从零创建演示文稿。后面我会把这两种方式都演示一遍。2. 动手写代码前先把PPT的“骨架”看清楚2.1 打开pptx就像打开zip包用压缩软件打开任意一份pptx你会看到类似这样的结构[Content_Types].xml _rels/.rels docProps/app.xml docProps/core.xml ppt/presentation.xml ppt/slides/slide1.xml ppt/slides/slide2.xml ppt/slideLayouts/slideLayout1.xml ppt/slideMasters/slideMaster1.xml ppt/theme/theme1.xml ppt/media/image1.png如果不理解这些文件之间的关系改起来就是摸黑走路。关系链大概是这样的presentation.xml负责引用所有幻灯片每一张slide1.xml要通过关系引用一个slideLayout版式版式再引用slideMaster母版母版再引用theme主题。PowerPoint渲染一张幻灯片时会把“幻灯片自身的内容 版式内容 母版内容 主题样式”叠加起来。这也是为什么你新建一张幻灯片什么都没画却能看到母版上的公司和日期。2.2 三个核心概念部件、关系、命名空间Open XML SDK里有三个概念绕不开Part部件对应上面解压出来的每个文件比如SlidePart对应slide.xmlSlideLayoutPart对应版式。Relationship关系文件之间通过rId关系ID相互引用。比如slide.xml里通过r:embedrId2引用图片部件。Namespace命名空间XML里的前缀最常碰到的是p:PresentationML和a:DrawingML。写代码时通常给SDK类型加两个别名P DocumentFormat.OpenXml.PresentationA DocumentFormat.OpenXml.Drawing。代码里所有对Slide的修改最后都要落到ShapeTree上。ShapeTree就是一张幻灯片里所有形状、图片、文本框的容器。理解了这三点操作PPT就没有神秘感了。2.3 最容易踩的坑不按关系链组装文件很多新手直接拿ZipArchive往pptx里塞一个xml文件以为就完事了。结果文件打开就提示“内容有问题需要修复”。原因基本都是没有在[Content_Types].xml里注册新部件或者没有在presentation.xml的关系文件里登记。这些细节用Open XML SDK能自动处理很大一部分它内部的AddNewPart、AddImagePart这些方法会帮你维护关系。所以我的建议是除非你只是临时打个包玩生产环境不要绕过SDK自行拼接XML否则文件名、路径、关系任何一个地方对不上整个文件就废了。3. 用C#和Open XML生成PPT的实操笔记3.1 环境准备和NuGet包安装我用的是.NET 6 Visual Studio 2022装SDK非常简单dotnet add package DocumentFormat.OpenXml或者Visual Studio里打开“管理NuGet程序包”搜索DocumentFormat.OpenXml安装最新稳定版即可。装好后csproj里会自动多出一行PackageReference IncludeDocumentFormat.OpenXml Version3.0.1 /这个包同时支持.NET Framework和.NET Core老项目也能用。然后代码文件顶部加几个using顺便起好别名using DocumentFormat.OpenXml.Packaging; using p DocumentFormat.OpenXml.Presentation; using a DocumentFormat.OpenXml.Drawing;3.2 推荐路线模板填充代替从零搭建从零用SDK创建一份完整PPT并不是不行但你要手动组装Slide、SlideLayout、SlideMaster、Theme那整整一长串依赖链。即使是最小可用的演示文稿也差不多要写200多行初始化和关系引用的代码维护成本相当高。我更推荐在实际项目里采用“模板填充”策略你先用PowerPoint手工做一份基础模板里面放好公司Logo、页眉页脚、占位符文本比如{{客户名称}}、{{日期}}然后在程序里打开这份pptx把占位符替换成真实数据。这么做有几个明显好处模板里的版式、主题、字体已经设计好生成出来的PPT天然好看。不需要处理复杂的部件依赖SDK自动维护关系。后续改样式只需改模板不用改代码。3.3 替换占位符文本打开一份模板pptx遍历所有幻灯片找到a:t节点上的占位符文字并替换。这是最简单、最常用的操作static void ReplacePlaceholder( PresentationDocument presentationDocument, Dictionarystring, string placeholders) { foreach (var slidePart in presentationDocument.PresentationPart.SlideParts) { foreach (var text in slidePart.Slide.Descendantsa.Text()) { if (!string.IsNullOrEmpty(text.Text) placeholders.ContainsKey(text.Text.Trim())) { text.Text placeholders[text.Text.Trim()]; } } slidePart.Slide.Save(); } }调用方式using (var doc PresentationDocument.Open(template.pptx, true)) { var map new Dictionarystring, string { { {{客户名称}}, 某某科技集团 }, { {{日期}}, DateTime.Now.ToString(yyyy年MM月dd日) } }; ReplacePlaceholder(doc, map); }注意PresentationDocument.Open的第二个参数必须传true表示可写。修改完之后记得调用slidePart.Slide.Save()否则关闭文件时可能不落盘。这个小坑我当初踩过文件明明改了关掉打开又变回去了。3.4 在指定位置插入图片插入图片要稍微绕一点但思路很清晰先把图片文件作为ImagePart加到SlidePart上拿到关系Id再在ShapeTree里构造一个Picture元素指定图片位置和尺寸。位置和尺寸用的是EMU单位1英寸等于914400 EMU1厘米约等于360000 EMU。下面的代码在左上角坐标(100, 100)处插入一张宽度5厘米、高度4厘米的图片static void InsertPicture( SlidePart slidePart, string imagePath, long xEmu, long yEmu, long widthEmu, long heightEmu) { ImagePart imagePart slidePart.AddImagePart(ImagePartType.Png); using (FileStream fs new FileStream(imagePath, FileMode.Open, FileAccess.Read)) { imagePart.FeedData(fs); } string relId slidePart.GetIdOfPart(imagePart); p.Picture picture new p.Picture( new p.NonVisualPictureProperties( new p.NonVisualDrawingProperties() { Id 100, Name Picture1 }, new p.NonVisualPictureDrawingProperties(new a.PictureLocks() { NoChangeAspect true }), new p.ApplicationNonVisualDrawingProperties() ), new p.BlipFill( new a.Blip() { Embed relId }, new a.Stretch(new a.FillRectangle()) ), new p.ShapeProperties( new a.Transform2D( new a.Offset() { X xEmu, Y yEmu }, new a.Extents() { Cx widthEmu, Cy heightEmu } ), new a.PresetGeometry(new a.AdjustValueList()) { Preset a.ShapeTypeValues.Rectangle } ) ); slidePart.Slide.CommonSlideData.ShapeTree.Append(picture); slidePart.Slide.Save(); }参数调用示例using (var doc PresentationDocument.Open(template.pptx, true)) { SlidePart slidePart doc.PresentationPart.GetSlidePartById(rId1); InsertPicture( slidePart, C:\images\logo.png, 1000000, 1000000, 1800000, 1440000 ); doc.PresentationPart.Presentation.Save(); }3.5 批量追加新幻灯片实际业务里经常要把一条条数据库记录变成一页页幻灯片。最稳妥的做法是在模板里预先放好一张“内容样张”代码复制这份样张生成新页。Open XML SDK没有直接提供“一键复制幻灯片”的API但可以通过拷贝SlidePart的流数据和关系来实现。这里有一个关键点复制完后新SlidePart里原样保留的rId引用不一定能对应上复制后的关系。我建议的做法是在复制后重新遍历新Slide的XML树把引用的关系和实际关系做映射或者更简单粗暴一点——复制后直接把这张新slide的文字、图片全部重写不依赖旧关系。下面这段代码实现了最简单的整页复制并追加到演示文稿末尾static SlidePart CloneSlide( PresentationDocument presentationDocument, string sourceSlideRelId) { var presentationPart presentationDocument.PresentationPart; var sourceSlidePart presentationPart.GetSlidePartById(sourceSlideRelId); // 新增一个SlidePart并把原始slide1.xml的二进制内容拷贝进来 SlidePart newSlidePart presentationPart.AddNewPartSlidePart(); using (Stream srcStream sourceSlidePart.GetStream(FileMode.Open, FileAccess.Read)) { newSlidePart.FeedData(srcStream); } // 拷贝版式引用 if (sourceSlidePart.SlideLayoutPart ! null) { newSlidePart.AddPart(sourceSlidePart.SlideLayoutPart); } // 在presentation.xml的SlideIdList中追加记录 SlideIdList slideIdList presentationPart.Presentation.SlideIdList; uint maxId slideIdList.ElementsSlideId().Max(s s.Id.Value); string newRelId presentationPart.GetIdOfPart(newSlidePart); slideIdList.Append(new SlideId { Id maxId 1, RelationshipId newRelId }); presentationPart.Presentation.Save(); return newSlidePart; }调用时先获取模板页的关系Id比如第一页通常是rId1using (var doc PresentationDocument.Open(template.pptx, true)) { SlidePart newSlide CloneSlide(doc, rId1); // 接着对新slide做文本替换、插图片等操作 doc.PresentationPart.Presentation.Save(); }如果你需要克隆整页后再改内容克隆出的SlidePart里文本节点和图片关系都是跟原页一致的。只要你继续用SDK提供的类型修改newSlide.Slide大部分常见场景够用。如果遇到关系错乱导致打不开我再推荐一个硬核办法不要克隆直接复制一份template.pptx作为新文件然后把不需要的页删掉这样每页的关系都是完整干净的。3.6 单位换算别弄错很多人在调整图片、文本位置时会困惑为什么设置了1000宽度图片还是小得看不见因为Open XML里长度单位全部是EMU。1像素约等于9525 EMU1英寸等于914400 EMU。建议你封装两个静态方法统一把像素或厘米转成EMUstatic long CmToEmu(double cm) { return (long)(cm * 360000); } static long PixelToEmu(double px, double dpi 96) { return (long)(px * 914400 / dpi); }我习惯所有对外参数都按厘米传内部换算一律走CmToEmu这样团队里其他人看代码也不容易云里雾里。4. 常见问题与排查技巧实录4.1 生成的文件打不开提示“需要修复”这个问题八成出在关系或者XML序列上。我做过的排查步骤按顺序列出来检查是否有部件被添加后没有保存比如slidePart.Slide.Save()漏掉了。检查是否手动改过rIdSDK里的RelationshipId不能随便改成字符串。检查ImagePartType和实际图片格式是否一致。PNG文件却写ImagePartType.Jpeg文件也能写进去但PowerPoint打开就会提示损坏。如果以上都没问题用Open XML SDK Productivity Tool打开文件它能直接显示哪个XML元素不符合schema。4.2 中文字体丢失或乱码Open XML里西文字体和中文字体是分开配置的一个叫LatinFont一个叫EastAsianFont。如果你只设置了西文字体中文环境大概率会回退成默认字体。设置方式是在RunProperties里同时设置var runProperties new a.RunProperties( new a.LatinFont() { Typeface Arial }, new a.EastAsianFont() { Typeface 微软雅黑 } );代码替换文本时如果新文本是中文而原来占位符所在的RunProperties里没有EastAsianFont最好手动补上否则不同机器上渲染效果会不一样。4.3 图片显示不出来或者位置全乱先确认你是不是开了“锁定纵横比”。即使代码里设置了PictureLocks.NoChangeAspecttruePPT在渲染时也会尽量保持原图比例如果指定的Cx和Cy与图片原始比例差太多会出现留白或者变形。建议插入前先用System.Drawing或SkiaSharp读取图片原始宽高按目标宽度等比计算出高度。还有一个特别容易忽略的点坐标原点在幻灯片左上角x向右增长y向下增长。如果你在别的地方习惯了屏幕坐标系到这里方向是一致的如果要计算底部对齐需要用幻灯片总高度减去元素高度。4.4 批量生成几百页很慢怎么办如果只是生成几十页性能无所谓。一旦到几百页、几千页就要注意了不要每生成一页就打开一次文件、保存一次再关闭。正确做法是打开一次PresentationDocument循环追加SlidePart积累到一定数量再Save一次。我的一个项目里曾经从每页200毫秒优化到全部处理完不超过3秒核心就是减少磁盘IO和XML序列化次数。另外Descendants重新查一次树很耗时。同一个SlidePart如果需要多次替换文本最好先把ShapeTree存到变量里不要反复调slidePart.Slide.Descendants。4.5 模板变量被替换成空字符串这个坑特隐蔽。PowerPoint文本框里的占位符如果被拆成多个Run比如{{客户是一段名称}}是另一段代码里想靠单个a:Text整体匹配就会失败。我的处理方式是把同一段落下的所有Run里的文本先拼成一个字符串整体替换后再拆回去。但这样处理Run样式比较麻烦所以更省事的办法是模板里尽量把占位符放在一个独立的文本框里不要和其他文字混在同一个段落中这样SDK读到的就是一个完整a:Text。最后分享一个我自己的小习惯拿到一份新pptx模板后第一次用SDK跑之前我会先用Open XML SDK Productivity Tool把文件结构看一遍重点确认幻灯片Id、版式引用关系、命名空间前缀。这套东西的底层逻辑其实很老派——关系链、命名空间、强类型节点理解了就不会被“生成PPT”这个听起来很复杂的词吓住。照着上面的代码改一改跑通一次模板填充和插入图片后面再扩展别的高级功能都会顺手很多。本文还有配套的精品资源点击获取