夜雨聆风学习资料网

ARTICLE · 1394962

.NET 转 PDF 还要装 Office?一个 NuGet 包,一行代码搞定

.NET 转 PDF 还要装 Office?一个 NuGet 包,一行代码搞定

朋友项目要加个导出:把 Word、Excel 转成 PDF。我一看,这不挺简单吗?上手才发现,服务器是一台没图形界面的 Linux,Office 根本装不了;退而求其次装 LibreOffice,结果 CI 每次构建都得重装一遍,镜像跟着大了一圈。后来才知道,有个 NuGet 包压根不用装这些。

.NET 项目里要转 PDF,多数人的第一反应还是找 Office 或 LibreOffice。本地开发机装一个也就算了,问题是要跑在容器里、CI 流水线里、无头服务器上——这些地方没图形界面,COM 自动化想都别想。

一边是装一套办公软件带来的镜像膨胀和环境依赖,一边是转出来的版式还没法保证一致。重的装了,效果还不一定好。

MiniPdf 就是冲着这个场景来的。它做 XLSX、DOCX、PPTX 到 PDF 的转换,给三种形态:.NET 类库、命令行工具、Native AOT 独立可执行文件。运行时不需要 Office、LibreOffice、Acrobat,也不用 COM 自动化。

01|装一个包就能用,三种形态按场景挑

先说最常用的类库形态:

dotnet add package MiniPdf

转的时候一行:

MiniPdf.ConvertToPdf("report.docx", "report.pdf")

要 byte[] 或者流的话,它有对应的重载,直接塞进 ASP.NET Core 的 File 返回就行。

命令行是另一条路:

dotnet tool install --global MiniPdf.Cli

装完直接 minipdf report.docx -o report.pdf。批量转一批文件、或者临时在服务器上跑一下,CLI 比写代码省事。

第三种是 Native AOT 的独立可执行文件,不带运行时,适合塞进镜像里——镜像能小一圈,这正是我们上次被卡住的地方。

02|Excel 和 Word 能调参数,但单位有个坑

Excel 这边可以指定工作表、设横向、适应页宽、压缩。报表列多的话,"适应页宽"基本是必开的,不然打出来一半跑到第二页。

Word 这边能设 A4 和页边距。这里有个坑:页边距的单位是 PDF point,72 point 等于一英寸。别按像素去想,按错了边距会差一大截。第一次用先照文档给的值抄,跑出来再调。

03|无头服务器的字体,得自己注册

真正上服务器,第一个翻车的往往是字体。机器上没装对应字体,转出来的 PDF 中文变方块,或者排版整个乱掉。

MiniPdf 给了 MiniPdf.RegisterFont,让你注册自己的 .ttf/.ttc 字体,进程级生效,一次就够。

要注意的是字体文件得自备,项目不分发。也就是说你得把字体文件一起放进镜像,不能指望包里带。上线前先把字体这件事解决掉,别等转出来全是方块再回头查。

04|别指望和 Office 版式一模一样

有个点主要注意的:它做的是实用转换,不追求和 Office 版式完全一致,复杂模板可能渲染有出入。

所以我的建议是,上线前先拿在线 demo 跑几个自己的文件比对一下。简单的合同、报表一般没问题,带复杂表格、图形、特殊字体的模板就要仔细看。别拿一个最复杂的模板去试,然后说工具不行——先摸清它的边界。

服务器上转 PDF 别再装整套 Office 了,一个 NuGet 包加一行代码就够,复杂模板先拿 demo 比一遍。

05|低内存 XLSX 模式,开之前先看限制

最后提一个容易踩的坑。它有个低内存 XLSX 模式,省内存,但不支持公式、合并单元格和绘图,而且没有自动回退。

意思是,你开着它转一份大表,省是省了,但公式结果、合并的单元格、图全没了,它也不会自动切回普通模式救你。

所以这个模式只适合纯数据、没公式没图的大表。开之前把限制说明读一遍,别默认它跟普通模式一样。

开源地址:https://github.com/mini-software/MiniPdf

写在最后

我认为最值得注意的,是它把"转 PDF"这件小事从装软件变成了装个包。

一个人做项目的话,装 MiniPdf.Cli 直接命令行转就够了,不用引类库。真遇到字体或者版式问题,再回头看 RegisterFont 和 demo 比对。

- End -

点击下方公众号卡片,关注我

回首页,搜索你想要的文档

在首页搜索框输入关键词,快速定位资料

文库首页搜索指引 立即搜索

相关学习资料