使用 Python 拆分 PDF 页面：一页变多页

PDF 页面拆分是一项常见的文档处理需求——当单个页面内容过多、包含多栏排版或需要将大幅面页面适配到更小的纸张时，将一页拆分为多页可以显著提升文档的可读性和打印适配性。Free Spire.PDF for Python 提供了基于模板绘制机制的页面拆分方案，能够在不依赖 Adobe Acrobat 等第三方软件的情况下完成这一操作。

环境准备

Free Spire.PDF for Python 可通过 pip 直接安装：

pip install Spire.PDF.Free

安装时会自动拉取 plum-dispatch 依赖。该库是独立的 Python PDF API，无需在系统中安装任何其他 PDF 工具。

注意：免费版存在 10 页的页数限制，在创建和加载 PDF 文档时要求文档不超过 10 页。

核心 API 与实现原理

Free Spire.PDF for Python 的页面拆分机制建立在 PdfPageBase.CreateTemplate() 与 PdfTemplate.Draw() 方法之上。其核心逻辑是：将源页面的内容渲染到一个模板对象中，然后将该模板绘制到新 PDF 文档的页面上。

关键 API 包括：

类/方法	作用
`PdfDocument`	PDF 文档的入口类，负责加载、保存和管理页面
`PdfDocument.LoadFromFile()`	加载源 PDF 文件
`PdfDocument.Pages.get_Item()`	按索引获取指定页面
`PdfPageBase.CreateTemplate()`	基于页面创建可复用的绘制模板
`PdfTemplate.Draw()`	将模板内容绘制到目标页面
`PdfDocument.PageSettings`	控制新文档的页面尺寸和边距

拆分时，通过调整新文档的 PageSettings.Width 和 PageSettings.Height 来控制目标页面的大小。当模板内容超出目标页面尺寸时，库会自动创建新页面并继续绘制剩余内容。

水平拆分：将一页上下分为两页

水平拆分（Horizontal Splitting）适用于将纵向内容过长的页面沿水平方向分割为上下两部分，例如将一张长表格或长篇文本拆分为连续的两页。

以下代码演示了将 PDF 的第一页从中间水平拆分为两个页面：

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

# 加载源 PDF 文档
pdf = PdfDocument()
pdf.LoadFromFile("Sample.pdf")

# 获取第一页（索引从 0 开始）
page = pdf.Pages.get_Item(0)

# 创建新的 PDF 文档
newPdf = PdfDocument()
# 将页边距设置为 0，避免绘制时产生偏移
newPdf.PageSettings.Margins.All = 0.0

# 获取源页面的宽高
width = page.Size.Width
height = page.Size.Height

# 水平拆分：宽度保持不变，高度设为源页面的一半
newPdf.PageSettings.Width = width
newPdf.PageSettings.Height = height / 2

# 添加新页面并绘制模板内容
newPage = newPdf.Pages.Add()
page.CreateTemplate().Draw(newPage, PointF(0.0, 0.0))

# 保存拆分后的文档
newPdf.SaveToFile("output/HorizontalSplit.pdf")
pdf.Close()
newPdf.Close()

执行逻辑：

newPdf.PageSettings.Height = height / 2 将目标页面高度设为源页面的一半；
page.CreateTemplate().Draw(newPage, PointF(0.0, 0.0)) 从源页面顶部开始绘制；
当绘制到目标页面底部时，剩余内容自动溢出到新页面。

最终输出的 PDF 包含两个页面，分别对应源页面的上半部分和下半部分。

垂直拆分：将一页左右分为两页

垂直拆分（Vertical Splitting）适用于将横向幅面较大或包含多栏排版的页面沿垂直方向分割，例如将 A3 幅面的报纸版面拆分为两个 A4 页面。

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

pdf = PdfDocument()
pdf.LoadFromFile("Sample.pdf")

page = pdf.Pages.get_Item(0)

newPdf = PdfDocument()
newPdf.PageSettings.Margins.All = 0.0

width = page.Size.Width
height = page.Size.Height

# 垂直拆分：高度保持不变，宽度设为源页面的一半
newPdf.PageSettings.Width = width / 2
newPdf.PageSettings.Height = height

newPage = newPdf.Pages.Add()
page.CreateTemplate().Draw(newPage, PointF(0.0, 0.0))

newPdf.SaveToFile("output/VerticalSplit.pdf")
pdf.Close()
newPdf.Close()

与水平拆分的区别仅在于目标页面的宽高设置——垂直拆分保持高度不变，将宽度设为源页面的一半。

扩展到任意分割比例与网格拆分

上述示例演示了二等分拆分。通过调整 PageSettings.Width 和 PageSettings.Height 的比例系数，可以实现任意比例的分割：

# 按 1/3 比例水平拆分（一页拆为三页）
newPdf.PageSettings.Width = width
newPdf.PageSettings.Height = height / 3

# 按 1/4 比例垂直拆分（一页拆为四页）
newPdf.PageSettings.Width = width / 4
newPdf.PageSettings.Height = height

对于需要将一页拆分为网格状多页的场景（如将大幅海报拆分为 2×2 的四个页面），可以结合上述两种方式：先水平拆分得到中间文档，再对中间文档的每个页面执行垂直拆分，或反向操作。

多页面文档的批量拆分

当需要对 PDF 中的多个页面分别进行拆分时，只需遍历 pdf.Pages 集合并对每个页面执行相同的拆分逻辑：

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

pdf = PdfDocument()
pdf.LoadFromFile("Sample.pdf")

for i in range(pdf.Pages.Count):
    page = pdf.Pages.get_Item(i)
    
    newPdf = PdfDocument()
    newPdf.PageSettings.Margins.All = 0.0
    
    width = page.Size.Width
    height = page.Size.Height
    
    # 按需选择水平或垂直拆分
    newPdf.PageSettings.Width = width
    newPdf.PageSettings.Height = height / 2
    
    newPage = newPdf.Pages.Add()
    page.CreateTemplate().Draw(newPage, PointF(0.0, 0.0))
    
    newPdf.SaveToFile(f"output/Split_Page_{i+1}.pdf")
    newPdf.Close()

pdf.Close()

总结

通过 CreateTemplate() + Draw() 的模板绘制机制，可实现灵活可控的 PDF 页面拆分方案。开发者只需调整目标页面的 Width 和 Height 属性，即可实现水平、垂直或任意比例的页面分割。该方法不依赖外部 PDF 工具，实现简洁，适用于报表拆分、大幅面适配、多栏排版重构等场景。

使用 Python 拆分 PDF 页面：一页变多页