Python代码实现为PDF添加页码(附详细教程)

pip install spire.pdf

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

from spire.pdf.common import *
from spire.pdf import *
# 1. 创建 PdfDocument 对象并加载 PDF 文件
doc = PdfDocument()
doc.LoadFromFile("示例文档.pdf")
# 2. 使用宋体字体，支持中文显示
font = PdfTrueTypeFont("SimSun", 12.0, PdfFontStyle.Regular, True)
brush = PdfBrushes.get_Black()      # 黑色画笔
pen = PdfPen(brush, 1.0)            # 用于画分隔线的笔
# 3. 创建页码字段和总页数字段
pageNumberField = PdfPageNumberField()
pageCountField = PdfPageCountField()
# 4. 组合成中文格式 "第 X 页 / 共 Y 页"
compositeField = PdfCompositeField(
    font, 
    brush, 
    "第 {0} 页 / 共 {1} 页",         # 中文页码模板
    [pageNumberField, pageCountField]
)
# 5. 设置页边距（单位：点，1点 = 1/72 英寸）
leftMargin = 54.0      # 左边距约 0.75 英寸
rightMargin = 54.0     # 右边距约 0.75 英寸
bottomMargin = 72.0    # 底边距约 1 英寸
# 6. 遍历所有页面，为每一页添加页码
for i in range(doc.Pages.Count):
    page = doc.Pages.get_Item(i)          # 获取当前页
    pageSize = page.Size                   # 获取页面尺寸
    # 6.1 绘制分隔线（可选，让页码区域更美观）
    lineY = pageSize.Height - bottomMargin + 15.0
    page.Canvas.DrawLine(
        pen, 
        leftMargin, 
        lineY, 
        pageSize.Width - rightMargin, 
        lineY
    )
    # 6.2 计算中文页码文本的宽度
    pageNumberSize = font.MeasureString(
        f"第 {i + 1} 页 / 共 {doc.Pages.Count} 页"
    )
    # 6.3 设置页码位置（居中）
    compositeField.Location = PointF(
        (pageSize.Width - pageNumberSize.Width) / 2,   # X 坐标：页面中心
        pageSize.Height - bottomMargin + 18.0           # Y 坐标：页脚位置
    )
    # 6.4 在页面上绘制页码
    compositeField.Draw(page.Canvas, 0.0, 0.0)
# 7. 保存并释放资源
doc.SaveToFile("中文页码.pdf")
doc.Dispose()

# 左对齐：X 坐标 = 左边距
compositeField.Location = PointF(
    leftMargin,                                    # 靠左
    pageSize.Height - bottomMargin + 18.0
)

# 右对齐：X 坐标 = 页面宽度 - 文本宽度 - 右边距
compositeField.Location = PointF(
    pageSize.Width - pageNumberSize.Width - rightMargin,   # 靠右
    pageSize.Height - bottomMargin + 18.0
)

compositeField = PdfCompositeField(
    font, brush, "{0} / {1}", 
    [pageNumberField, pageCountField]
)
# 显示效果：1 / 10

compositeField = PdfCompositeField(
    font, brush, "- {0} / {1} -", 
    [pageNumberField, pageCountField]
)
# 显示效果：- 1 / 10 -

compositeField = PdfCompositeField(
    font, brush, "第 {0} 页（共 {1} 页）", 
    [pageNumberField, pageCountField]
)
# 显示效果：第 1 页（共 10 页）

# 只需要页码，不需要总页数
compositeField = PdfCompositeField(
    font, brush, "第 {0} 页", 
    [pageNumberField]
)
# 显示效果：第 1 页

# 示例：使用微软雅黑字体
font = PdfTrueTypeFont("Microsoft YaHei", 12.0, PdfFontStyle.Regular, True)

leftMargin = 54.0      # 增大 → 页码右移（左对齐时），或增加左右空白区
rightMargin = 54.0     # 增大 → 页码左移（右对齐时）
bottomMargin = 72.0    # 增大 → 页码上移，减小 → 页码下移

# 分隔线的垂直位置（当前为 bottomMargin 上方 15 点）
lineY = pageSize.Height - bottomMargin + 15.0

# 页码的垂直位置（当前为 bottomMargin 上方 18 点）
compositeField.Location = PointF(x, pageSize.Height - bottomMargin + 18.0)

# 将 12 号字改为 14 号字
font = PdfTrueTypeFont("SimSun", 14.0, PdfFontStyle.Regular, True)

for i in range(1, doc.Pages.Count):  # 从索引 1（第2页）开始

for i in range(doc.Pages.Count):
    if i >= 2 and i <= 10:  # 只给第3页到第11页添加页码
        # 添加页码的代码