C#如何做PDF报表生成？QuestPDF与iTextSharp库对比与使用教程

来源：这里教程网时间：2026-02-21 17:31:29 作者：

在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;
<p>// 设置全局字体（支持中文）
DocumentSettings.DefaultFontEmbedding = FontEmbedding.Always;</p><p>var document = Document.Create(container =>
{
container.Page(page =>
{
page.Margin(50);</p><pre class='brush:php;toolbar:false;'>    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;
<p>var doc = new Document(PageSize.A4, 50, 50, 50, 50);
var writer = PdfWriter.GetInstance(doc, new FileStream("report_itext.pdf", FileMode.Create));
doc.Open();</p><p>// 添加标题
var titleFont = FontFactory.GetFont(FontFactory.HELVETICA, 18, Font.BOLD);
doc.Add(new Paragraph("销售报表", titleFont));</p><p>doc.Add(new Paragraph(" ")); // 空行</p><p>// 添加内容
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));</p><p>doc.Close();
writer.Close();</p>

可以看到，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"));
<p>// 使用时指定字体族
.Text("客户：张三")
.FontFamily("SimSun")</p>

iTextSharp 使用中文字体：

// 加载宋体
BaseFont bfChinese = BaseFont.CreateFont("simsun.ttc,0", BaseFont.IDENTITY_H, BaseFont.NOT_EMBEDDED);
var fontChinese = new Font(bfChinese, 12);
<p>doc.Add(new Paragraph("客户：张三", fontChinese));</p>

注意：确保字体文件随程序部署，否则运行时报错。

基本上就这些。如果你要做的是标准业务报表，推荐用 QuestPDF，开发快、结构清晰；如果要操作已有 PDF 文件或做电子签章类功能，再考虑 iTextSharp。选择时务必注意许可证问题，避免法律风险。