通过 Python 在 PDF 中添加页面

在日常办公和数据处理中，PDF文件因其格式稳定性被广泛使用，而"添加页面"许多Python开发者在处理文档自动化、报告生成或数据可视化时的常见需求之一。无论是补充空白页、插入现有PDF内容，还是添加带自定义文本/图片的页面，掌握"在PDF中添加页面"的方法都能大幅提升工作效率。

Spire.PDF for Python 作为一款功能全面的 PDF 处理库，提供了简洁直观的 API 来实现各类页面添加场景。本文将介绍该库的使用方法，结合具体场景给出可复用的代码示例。

一、环境准备

1. 安装 Spire.PDF for Python

该库支持 Python 3.6 及以上版本，可通过 pip 命令快速安装：

复制代码

pip install Spire.PDF

免费版（单文件限制10页）

复制代码

pip install Spire.PDF.Free

二、核心场景：PDF页面添加实现

Spire.PDF for Python通过 PdfDocument 类管理PDF文件，支持在PDF末尾添加空白页、指定位置插入页面以及合并多个PDF文件中的指定页面等场景。

场景1：在PDF末尾添加空白页

适用于需要补充空白页供手写、批注的场景，支持自定义页面大小和方向。

代码示例：

python 复制代码

from spire.pdf import *
from spire.pdf.common import *

# 加载现有 PDF
pdf = PdfDocument()
pdf.LoadFromFile("input.pdf")

# 添加新空白页到文档末尾
pdf.Pages.Add(PdfPageSize.A4())

# 保存 PDF
pdf.SaveToFile("output.pdf")

📌 关键点：

PdfDocument.LoadFromFile()：加载现有PDF文件；
PdfPages.Add()：无参数时添加默认A4纵向空白页，也可通过 PdfPageSize 和 PdfMargins 指定页面属性；
SaveToFile()：保存修改后的文件，支持PDF、PDF/A等格式。

场景2：在指定位置插入空白页

适用于需要在PDF中间插入空白页的场景（例如在第2页后插入）。

代码示例：

python 复制代码

from spire.pdf.common import *
from spire.pdf import *

# 加载现有 PDF
pdf = PdfDocument()
pdf.LoadFromFile("input.pdf")

# 插入到第2页（索引从0开始）
pdf.Pages.Insert(1)

# 保存 PDF
pdf.SaveToFile("AddPage.pdf")
pdf.Close()

📌 关键说明：

PdfPages.Insert(insert_index)：在指定索引位置插入空白页，索引从0开始（例如insert_index=0表示插入到第1页之前）；
插入后，后续页面会自动后移。

场景3：添加其他PDF的页面（PDF合并）

适用于需要将多个PDF文件的指定页面合并到一个文件中的场景（例如合并报告、合同附件）。

代码示例：

python 复制代码

from spire.pdf import *
from spire.pdf.common import *

# 加载输入 PDF 文档
file1 = "Sample1.pdf"
file2 = "Sample2.pdf"
files = [file1, file2]
pdfs = []
for file in files:
    pdfs.append(PdfDocument(file))

# 创建新 PDF 文档
newPdf = PdfDocument()

# 将输入文档指定页面插入新建 PDF 文档
newPdf.InsertPage(pdfs[0], 0)
newPdf.InsertPageRange(pdfs[1], 0, 1)

# 保存新建 PDF
newPdf.SaveToFile("SelectedPages.pdf")

📌 关键说明：

InsertPage：插入指定索引处的页面（单个页面）；
InsertPageRange：插入指定索引处的页面范围（多个页面）；
合并时保留原PDF的页面格式、内容和权限设置，兼容性较好。

三、注意事项

文件路径问题：加载和保存PDF时，建议使用绝对路径，避免因相对路径错误导致文件找不到；
兼容性：支持处理PDF 1.0-1.7版本，以及PDF/A-1B、PDF/A-2B等标准化格式，支持加密PDF（需先解密）；
资源释放 ：使用完毕后需调用PdfDocument.Close()方法释放资源，避免内存泄漏；

四、总结

Spire.PDF for Python 提供了简洁高效的 API，能够轻松实现空白页添加、指定位置插入、PDF合并等核心需求。其优势在于 API 设计直观、功能覆盖全面，且文档完善（官方提供详细的API文档和示例代码），适合各类 PDF 处理场景。