<p>QuestPDF 是 .NET 平台最轻量现代的 PDF 生成库，基于 Fluent API 用 C# 直接描述文档结构，需注册中文字体（如 Noto Sans CJK）以支持中文，安装 via NuGet，.NET 6+ 原生兼容。</p>
用 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 支持表格、图片、分页、页码、条件内容等实用特性：
-
表格：用
Table+ColumnsDefinition+Cell构建，支持自动列宽、跨行跨列 -
图片：用
.Image(bytes)或.Image(path)，支持缩放、居中、比例约束 -
页码：在页脚中用
page.Number()+page.TotalPages()，如"第 {0} 页，共 {1} 页" -
条件渲染：C# 的
if/foreach可直接嵌入布局逻辑，比如只在数据非空时显示某区块 -
自定义字体：需先注册（支持 TTF/OTF），再用
.Font(...)应用，中文需指定支持 Unicode 的字体（如 Noto Sans CJK）
中文支持与字体配置
默认不支持中文，需手动加载中文字体：
// 注册字体（推荐放在程序启动时执行一次）
QuestPDF.Settings.License = LicenseType.Community;
FontManager.RegisterFont(File.ReadAllBytes("NotoSansCJKsc-Regular.otf"));
<p>// 使用时指定字体
.Text("你好，世界！").Font("Noto Sans CJK SC");推荐字体：
- 免费可商用：Google 的 Noto Sans CJK（SC/TC/JP/KO 版本按需选）
- 系统字体（Windows）：
"Microsoft YaHei"或"SimSun"，但跨平台部署需谨慎
未正确注册字体时，中文会显示为空白或方块，这是新手最常遇到的问题。
基本上就这些。QuestPDF 上手快、调试直观、扩展性强，适合报表、合同、发票、导出文档等场景。不复杂但容易忽略字体和布局嵌套层级——多看官方 示例库，5 分钟就能写出专业 PDF。
