ASP.NET Core 6下如何免费实现docx模板填充后导出PDF

所有方案均满足无Office Interop依赖、不调用第三方在线服务、无高额授权费、模板可直接用Word编辑的要求，按落地便捷度排序：

方案1：OpenXML SDK + LibreOffice 无头转换（最贴合docx使用习惯） #

• 模板填充环节直接用微软官方开源的DocumentFormat.OpenXml，MIT协议授权，完全无商用限制，专门用于处理docx格式，全程不需要依赖本机安装Office。你只需要提前在Word里给模板加统一格式的占位符，比如{{客户名称}}、{{订单金额}}这类文本标记，通过SDK就能实现文本替换、表格循环行填充、图片插入等常见需求，服务器部署没有额外环境依赖。

  注意：不要直接用正则匹配解压后的docx内部xml做替换，Word会自动把连续文本拆成多个独立节点，很容易导致占位符匹配失败，用OpenXML SDK提供的文本节点遍历方法做替换，稳定性高很多。简单的占位符替换逻辑几十行代码就能封装完成，不需要额外引入付费组件。

• PDF转换环节用开源免费的LibreOffice无头模式实现，没有页数限制、没有商用授权门槛（MPL2.0协议，独立进程调用不涉及协议传染）。部署时可以随应用发布便携版LibreOffice，不需要在服务器上手动安装办公软件，ASP.NET Core里通过进程调用执行转换命令即可，Windows、Linux、Docker部署环境全兼容，核心转换命令如下：

  soffice --headless --norestore --convert-to pdf "填充完成的docx文件绝对路径" --outdir "PDF输出目录绝对路径"
  

• 这套方案最大的优势是模板100%兼容Word编辑，甚至可以直接拿业务人员做好的现有docx文档，加完占位符就投入使用，不需要额外学习专用的报表设计工具，学习成本极低。

方案2：Word可编辑模板 + PuppeteerSharp 转PDF（排版精度更高） #

如果你对PDF导出的排版一致性要求更高，不想处理docx转PDF偶尔出现的格式偏移问题，可以选这套流程：

• 模板直接用Word编辑完成后，另存为清理过冗余标签的HTML文件，用Scriban（MIT协议开源模板引擎）实现变量替换、循环渲染、条件判断等逻辑，生成最终的HTML内容。
• 用PuppeteerSharp（MIT协议，本地调用Chromium无头内核）把填充完成的HTML转成PDF，分页规则、页眉页脚、水印、自定义字体这些配置比docx转PDF更灵活，排版效果跨环境完全一致，不会出现不同服务器转换出来格式不一样的问题。
• 这套方案的缺点是后续调整模板后，需要重新从Word导出一次HTML，比直接修改docx多一步操作，但胜在转PDF的稳定性高，适合对输出格式要求严格的场景。

避坑说明 #

• 不要轻信各类商业docx组件的“免费版”宣传，绝大多数免费版都有10页/500段落的转换限制，商用场景下很容易触发阈值，出现内容截断、强制加版权水印的问题。
• 不要用服务器端安装Office+Interop调用的方案，微软官方本身就不支持Office的服务器端自动化，高并发场景下极容易出现进程卡死、内存泄漏、文件锁不释放的问题，而且服务器端安装Office本身就需要支付正版授权费用，成本高稳定性差。
• 你提到的RDLC方案确实能实现报表导出，但模板设计门槛高，必须安装专用的报表设计器才能修改，远不如Word编辑模板的适配性好，普通业务人员就能直接调整模板内容，不需要开发介入。

内容的提问来源于stack exchange，提问作者user3953989