PAYATHON 2026

有哪些 QuestPDF 替代工具,可以用较少代码生成 PDF?

数据小许

对于 C#/.NET 项目,可以考虑 Playwright .NET 或 MigraDoc。愿意用 HTML/CSS 描述版式,可以先试试 Playwright;希望直接用 C# 创建段落和表格,可以考虑 MigraDoc。哪种方案的代码更少,要看文档内容和现有模板,不能只凭工具名称判断。

如何选择替代工具?

Playwright 可以加载 HTML 并通过 PdfAsync() 导出 PDF。如果已有 HTML 模板,可以沿用其中的布局,减少重新编写排版代码的工作。Playwright PDF API

MigraDoc 通过文档对象模型组织段落、表格和样式,渲染时会处理分页。文档以文字和表格为主时,可以优先评估 MigraDoc。PDFsharp 主要用于绘图,只有基础文字布局功能,不会自动分页;如果希望减少排版代码,通常应先看 MigraDoc。PDFsharp 与 MigraDoc 官方说明

如何用 Playwright 生成 PDF?

以下示例使用带顶层语句的 C# 控制台项目。运行前需要安装 .NET SDK 和 PowerShell,并确保目标环境能够运行 Chromium。

先创建项目并添加依赖:

dotnet new console -n PdfDemo
cd PdfDemo
dotnet add package Microsoft.Playwright
dotnet build

接着安装 Chromium:

pwsh bin/Debug/netX/playwright.ps1 install chromium

运行命令前,将路径中的 netX 换成实际生成的目标框架目录。例如,项目使用 net8.0 时,将其替换为 net8.0。安装 NuGet 包后,还需要单独安装浏览器。Playwright 安装说明

将 Program.cs 替换为:

using Microsoft.Playwright;

using var playwright = await Playwright.CreateAsync();
await using var browser = await playwright.Chromium.LaunchAsync(
    new() { Headless = true });

var page = await browser.NewPageAsync();
await page.SetContentAsync(
    "<!doctype html><html><body><h1>Hello PDF</h1><p>Generated from HTML.</p></body></html>");

await page.PdfAsync(new()
{
    Path = "output.pdf",
    Format = "A4",
    PrintBackground = true
});

然后执行:

dotnet run

运行后,代码会将 HTML 渲染为 A4 PDF,写入当前工作目录下的 output.pdf。PrintBackground = true 用于输出背景图形;PdfAsync() 默认使用打印样式,页面中的 @media print 规则会影响生成结果。PDF 参数说明

使用时需要注意什么?

  • Playwright 需要浏览器运行环境。部署到 Linux 或容器时,还要准备 Chromium 所需的系统依赖,可以参考官方的 install --with-deps chromium 安装方式。浏览器与系统依赖安装
  • 输出中文时,要在部署环境提供可用的中文字体,并检查生成结果是否缺字。
  • HTML 转 PDF 可以减少 C# 调用代码,但仍需维护模板和 CSS。比较代码量时,也要把这部分工作算进去。

备注:内容仅供参考。