C#如何实现PDF文件生成 QuestPDF库使用教程

QuestPDF 是 .NET 平台最轻量现代的 PDF 生成库，基于 Fluent API 用 C# 直接描述文档结构，需注册中文字体（如 Noto Sans CJK）以支持中文，安装 via NuGet，.NET 6+ 原生兼容。

用 C# 生成 PDF，QuestPDF 是目前最轻量、现代且易上手的开源库之一。它基于 Fluent API 设计，用 C# 代码直接描述文档结构（类似 HTML + CSS），无需模板引擎或外部依赖，编译即用。

安装 QuestPDF

在项目中通过 NuGet 安装：

• Visual Studio：右键项目 → “管理 NuGet 包” → 搜索并安装 QuestPDF
• 命令行：dotnet add package QuestPDF

注意：.NET 6+ 项目可直接使用；若用 .NET Framework，请确认版本兼容性（建议升级至 .NET 6/7/8）。

快速生成一个简单 PDF

以下是最小可运行示例，生成含标题和段落的 PDF：

using QuestPDF.Fluent;
using QuestPDF.Helpers;
using QuestPDF.Infrastructure;
<p>// 初始化（只需一次，通常放在 Program.cs 或 Startup）
Document.Create(container =>
{
container.Page(page =>
{
page.Size(PageSizes.A4);
page.Margin(2, Unit.Centimetre);
page.Content().Element(ComposeContent);
});
})
.GeneratePdf("output.pdf");</p><p>void ComposeContent(IContainer container)
{
container
.PaddingVertical(40)
.Column(column =>
{
column.Item().Text("欢迎使用 QuestPDF！").FontSize(24).Bold();
column.Item().Text("这是一个由 C# 代码生成的 PDF 文档。").FontSize(14);
});
}

登录后复制

运行后会在当前目录生成 output.pdf。关键点：

• Document.Create 定义整个文档
• Page 控制页面尺寸、边距、页眉页脚
• Content() 是主体区域，用 Column/Row/Grid 布局
• 所有样式（字体、颜色、对齐等）链式调用，直观清晰

常用功能与写法

QuestPDF 支持表格、图片、分页、页码、条件内容等实用特性：

标签： css html go windows ai pdf win microsoft google c# .net