QuestPDF适合快速生成美观报表，API简洁易用，支持自动布局和中文显示，MIT免费授权；iTextSharp功能强大但API繁琐，需手动控制布局，LGPL版可商用，适用于复杂PDF操作。
在C#开发中，生成PDF报表是常见的需求，尤其是在企业级应用、财务系统或导出功能中。目前主流的库有 QuestPDF 和 iTextSharp，它们各有特点。下面从设计理念、使用方式、功能支持和实际应用场景进行对比，并提供简单易懂的使用教程。
1. QuestPDF 简介与使用
QuestPDF 是一个现代、声明式、基于流式布局的 .NET PDF 生成库，强调代码可读性和开发效率。它不依赖外部工具，完全用 C# 实现，适合需要快速构建美观报表的项目。
优点：
- 语法简洁，使用 Fluent API 构建文档结构
- 内置响应式布局，自动处理分页与换行
- 支持中文（需指定字体）
- 无需学习 PDF 底层结构
- 开源免费，MIT 许可证
安装方法：
dotnet add package QuestPDF示例：生成简单报表
using QuestPDF.Fluent; using QuestPDF.Helpers; using QuestPDF.Infrastructure;// 设置全局字体（支持中文） DocumentSettings.DefaultFontEmbedding = FontEmbedding.Always;
var document = Document.Create(container => { container.Page(page => { page.Margin(50);
page.Header().Text("销售报表").FontSize(20).Bold(); page.Content().Column(column => { column.Item().Text("订单编号：ORD-2024-001"); column.Item().Text("客户名称：张三"); column.Item().Text("总金额：¥998.00"); }); });});
// 输出到文件 document.GeneratePdf("report.pdf");
这个例子展示了如何用链式调用构建页面结构，逻辑清晰，易于维护。
2. iTextSharp 简介与使用
iTextSharp 是老牌 PDF 操作库 iText 的 .NET 移植版本，功能强大，但最新版（7+）采用 AGPL 许可，商业项目需谨慎使用。社区常用的是较早的 LGPL 版本（如 5.5.13），称为 itextsharp-lGPL。
优点：
- 功能全面：支持加密、签名、表单、水印等高级特性
- 底层控制能力强，适合复杂 PDF 操作
- 广泛用于已有系统，生态成熟
缺点：
- API 较为繁琐，代码冗长
- 需要手动管理布局、坐标、分页
- 新版本有许可证限制
安装方法（使用 lGPL 版本避免授权问题）：
dotnet add package itextsharp.LGPL -Version 5.5.13
示例：生成基础 PDF 报表
using iTextSharp.text; using iTextSharp.text.pdf; using System.IO;var doc = new Document(PageSize.A4, 50, 50, 50, 50); var writer = PdfWriter.GetInstance(doc, new FileStream("report_itext.pdf", FileMode.Create)); doc.Open();
// 添加标题 var titleFont = FontFactory.GetFont(FontFactory.HELVETICA, 18, Font.BOLD); doc.Add(new Paragraph("销售报表", titleFont));
doc.Add(new Paragraph(" ")); // 空行
// 添加内容 var contentFont = FontFactory.GetFont(FontFactory.HELVETICA, 12); doc.Add(new Paragraph("订单编号：ORD-2024-001", contentFont)); doc.Add(new Paragraph("客户名称：张三", contentFont)); doc.Add(new Paragraph("总金额：¥998.00", contentFont));
doc.Close(); writer.Close();
可以看到，iTextSharp 更接近“绘图”模式，需要显式打开/关闭文档，逐项添加元素。
3. 对比总结：选哪个？
| 维度 | QuestPDF | iTextSharp (LGPL) |
|---|---|---|
| 学习曲线 | 低，API 直观 | 中高，需理解 PDF 结构 |
| 开发效率 | 高，适合快速出报表 | 较低，代码量大 |
| 布局能力 | 自动分页、响应式容器 | 手动控制位置 |
| 中文支持 | 需注册字体（TTF） | 需使用 BaseFont 加载中文字体 |
| 许可证 | MIT，可商用 | LGPL 可商用，AGPL 版受限 |
| 适用场景 | 常规报表、发票、导出文档 | 复杂 PDF 编辑、加签、模板填充 |
4. 中文显示配置（关键！）
两个库默认都不支持中文，必须加载中文字体（如 SimSun、Microsoft YaHei）。
QuestPDF 配置中文字体：
// 注册字体（放在程序启动时）
FontManager.RegisterFont(System.IO.File.ReadAllBytes("simsun.ttc"));
// 使用时指定字体族
.Text("客户：张三")
.FontFamily("SimSun")
iTextSharp 使用中文字体：
// 加载宋体
BaseFont bfChinese = BaseFont.CreateFont("simsun.ttc,0", BaseFont.IDENTITY_H, BaseFont.NOT_EMBEDDED);
var fontChinese = new Font(bfChinese, 12);
doc.Add(new Paragraph("客户：张三", fontChinese));
注意：确保字体文件随程序部署，否则运行时报错。
基本上就这些。如果你要做的是标准业务报表，推荐用 QuestPDF，开发快、结构清晰；如果要操作已有 PDF 文件或做电子签章类功能，再考虑 iTextSharp。选择时务必注意许可证问题，避免法律风险。
