在C#项目中把多页PDF拆成单页文件，本质是从源PDF文档中按页码提取页面对象，再分别写入新的PDF文档。借助iText7这类成熟的PDF操作库，开发者不需要关心PDF底层二进制结构，只要调用对应的文档与页面API就能完成拆分。
一、环境准备与NuGet引用
实现PDF拆分首先要引入iText7的.NET库。iText7是目前C#里比较常用的开源PDF处理组件，支持读取、写入、合并、拆分等完整功能。通过NuGet包管理器安装即可，不需要额外配置本地环境。
在Visual Studio中打开包管理器控制台，执行下面命令安装核心包：
// 在NuGet包管理器控制台执行 // Install-Package itext7 using iText.Kernel.Pdf; using iText.Kernel.Utils; using System.IO;
安装完成后，项目中就可以使用PdfReader、PdfWriter和PdfDocument等类型。需要注意的是，iText7的AGPL协议要求商业用途购买授权，内部工具或非商业场景可以直接使用。
二、基础拆分实现
最直观的拆分方式是循环遍历源PDF的每一页，对每一页创建一个新的PdfDocument，并用PdfPage的复制方法把页面加入新文档。下面示例演示将一个input.pdf拆分为page_1.pdf、page_2.pdf等单页文件。
using iText.Kernel.Pdf;
using System.IO;
class PdfSplitter
{
static void SplitPdf(string sourcePath, string outputDir)
{
// 打开源PDF
using (PdfReader reader = new PdfReader(sourcePath))
using (PdfDocument sourceDoc = new PdfDocument(reader))
{
int totalPages = sourceDoc.GetNumberOfPages();
// 逐页拆分
for (int i = 1; i <= totalPages; i++)
{
string outPath = Path.Combine(outputDir, $"page_{i}.pdf");
using (PdfWriter writer = new PdfWriter(outPath))
using (PdfDocument outDoc = new PdfDocument(writer))
{
// 复制第i页到新文档
sourceDoc.CopyPagesTo(i, i, outDoc);
}
}
}
}
}
上面代码中CopyPagesTo方法接收起始页和结束页，以及目标文档。因为起止都传i，所以每次只复制一页。这种方式逻辑简单，适合页数不多、对性能要求不高的场景。
要注意的是，每次循环都新建了PdfWriter和PdfDocument，频繁IO打开关闭文件在批量处理大文件时会有开销。如果PDF只有几页，这种写法完全够用且易于理解。
三、使用PdfSplitter类优化
iText7提供了一个专门的PdfSplitter抽象类，可以更优雅地处理拆分逻辑，尤其适合按规则拆分（比如每页一个文件，或每N页一个文件）。继承该类并重写GetNextPdfWriter方法，就能定制输出文件。
using iText.Kernel.Pdf;
using iText.Kernel.Utils;
using System.IO;
class SinglePageSplitter : PdfSplitter
{
private readonly string _dir;
private int _index = 0;
public SinglePageSplitter(PdfDocument pdfDocument, string dir) : base(pdfDocument)
{
_dir = dir;
}
protected override PdfWriter GetNextPdfWriter(PageRange documentPageRange)
{
_index++;
string path = Path.Combine(_dir, $"split_{_index}.pdf");
return new PdfWriter(path);
}
}
class Program
{
static void Main()
{
using (PdfReader reader = new PdfReader("input.pdf"))
using (PdfDocument doc = new PdfDocument(reader))
{
SinglePageSplitter splitter = new SinglePageSplitter(doc, "output");
// 按每页拆分
splitter.SplitByPageCount(1);
}
}
}
SplitByPageCount(1)表示每个新文档只放一页。相比手动循环，PdfSplitter在内部做了更好的资源管理，代码可读性也更强。如果后续要改成每三页一个文件，只要把参数改为3并调整文件名规则即可。
这种写法在拆分几百页的PDF时表现稳定，不会因为频繁创建对象导致明显卡顿。对于服务端批量任务，推荐使用这种方式而非基础循环。
四、资源与字体处理注意点
拆分PDF时容易遇到的一个问题是：某些单页文件打开后文字变成方块，或者图片丢失。这通常是因为源文档使用了嵌入字体或外部资源，而拆分时没有正确保留引用。
iText7的CopyPagesTo和PdfSplitter默认会处理资源复制，但如果你在拆分同时对页面做修改（比如加水印、删内容），就要手动确保字体对象被加入新文档。下面是一个保留字体的简单说明：
// 若需操作页面内容，先获取页面
PdfPage page = sourceDoc.GetPage(i);
// 复制页面会自动带字体，但自行绘制时要注册字体
// PdfFont font = PdfFontFactory.CreateFont("STSong-Light", "UniGB-UCS2-H");
// 仅在新增文本时使用，拆分纯复制无需此步
如果只是原样拆分，不改动内容，iText7会自动把该页依赖的字体、图片等资源写入新文件，不需要额外代码。但要是源文件本身损坏或不标准，拆分后可能仍无法正常显示，这种属于原文件问题，需要在拆分前先修复源PDF。
五、文件流与内存流对比
在Web接口里拆分PDF，有时不希望直接写磁盘，而是返回内存流给前端。下面用表格列出两种方式的差异：
| 方式 | 优点 | 缺点 | 适用场景 |
|---|---|---|---|
| 文件流写磁盘 | 实现简单，便于核查结果 | 磁盘IO占用，需清理临时文件 | 本地工具、后台任务 |
| 内存流返回 | 无磁盘依赖，适合接口 | 大文件占用内存高 | Web API、云函数 |
使用内存流时，可以把PdfWriter构造为接收MemoryStream，拆分完直接拿字节数组。示例如下：
using (PdfReader reader = new PdfReader("input.pdf"))
using (PdfDocument src = new PdfDocument(reader))
{
MemoryStream ms = new MemoryStream();
using (PdfWriter writer = new PdfWriter(ms))
using (PdfDocument outDoc = new PdfDocument(writer))
{
src.CopyPagesTo(1, 1, outDoc);
}
byte[] pdfBytes = ms.ToArray();
// 可通过接口返回 pdfBytes
}
内存流方式在页数和文件体积较小时很方便，但遇到上千页的PDF，建议还是落盘处理，避免服务内存溢出。实际项目中可以根据页数动态选择策略。
六、常见错误与排查
初学者常犯的错误是复用同一个PdfWriter写多个文件，或者没有用using释放文档对象，导致文件被锁死或内容不完整。下面列出几个要点：
- 每个单页文件必须新建独立的
PdfWriter和PdfDocument。 - 源
PdfReader在整个拆分循环结束前不能关闭。 - 输出目录要提前创建，否则写文件会抛异常。
- 遇到加密PDF，需要在
PdfReader构造时传入密码。
如果拆分后文件大小为0，通常是没有正确调用CopyPagesTo或文档未释放。加上using语句能有效避免这类低级错误。对于加密文件，可以这样打开：
// 带密码的PDF
using (PdfReader reader = new PdfReader("encrypted.pdf",
new ReaderProperties().SetPassword(System.Text.Encoding.UTF8.GetBytes("123456"))))
using (PdfDocument doc = new PdfDocument(reader))
{
// 后续拆分逻辑相同
}
掌握以上几点，基本可以应对日常C#拆分PDF的全部需求。无论是做合同管理系统、报表导出模块，还是文件预处理服务，都能快速集成这段代码。