如何使用 Python 在 PDF 每页顶部添加可点击超链接-Python教程-PHP中文网

本文介绍如何利用 pypdf 和 fpdf2 在 PDF 文档的每一页顶部精准添加统一或动态超链接，适用于为扫描/OCR 文档批量添加导航入口（如返回索引页），避免生成损坏文件。

本文介绍如何利用 `pypdf` 和 `fpdf2` 在 pdf 文档的每一页顶部精准添加统一或动态超链接，适用于为扫描/ocr 文档批量添加导航入口（如返回索引页），避免生成损坏文件。

在处理大量已扫描并 OCR 处理过的 PDF 文档时，常需为每页添加一个醒目的、可点击的超链接（例如指向父级文档索引页），方便搜索引擎用户直接跳转回上下文。直接修改原始 PDF 页面内容较为复杂，而“覆盖页（stamp）+ 合并”是稳定可靠的方案：先用 fpdf2 生成仅含超链接的透明覆盖页（PDF），再用 pypdf 将其逐页合并到目标文档顶部。

以下为完整实现流程：

✅ 前置依赖

确保安装兼容版本（经验证 pypdf==4.1.0 与 fpdf2==2.7.8 组合稳定）：

python学习

Python 编程学习助手 skill，面向零基础用户。当用户表达以下意图时触发： - 学习 Python 基础概念（变量、数据类型、循环、函数、类等） - 请求 Python 练习题或测验 - 请求审查或调试 Python 代码 - 请求 Python 项目实战指导（爬虫、数据分析、Web 开发等入门项目） - 泛化表述如"教我 Python""我想学编程""Python 怎么写""帮我学 Python" 此 skill

下载

pip install pypdf==4.1.0 fpdf2==2.7.8

✅ 核心代码详解

import fpdf
from fpdf.enums import XPos, YPos
from pypdf import PdfReader, PdfWriter


def generate_overlay(target_path: str, text: str, link: str) -> None:
    """生成单页 PDF 覆盖层：顶部居中显示蓝色可点击链接"""
    class PDF(fpdf.FPDF):
        def header(self) -> None:
            self.set_font("helvetica", "B", 12)
            self.set_text_color(0, 0, 255)  # RGB 蓝色，增强可读性与点击感
            link_width = self.get_string_width(text)
            self.cell(
                w=link_width,
                h=10,
                text=text,
                new_x=XPos.RIGHT,
                new_y=YPos.TOP,
                align="C",
                link=link  # 关键：自动创建 PDF 内部超链接动作
            )

    pdf = PDF()
    pdf.add_page()  # 必须调用，否则 output 报错
    pdf.output(target_path)


def stamp(original_path: str, stamp_path: str, out_path: str) -> None:
    """将覆盖页 stamp.pdf 合并到 original.pdf 每页顶部（非覆盖文字，而是叠加图层）"""
    stamp_page = PdfReader(stamp_path).pages[0]
    writer = PdfWriter(clone_from=original_path)

    for page in writer.pages:
        # over=False 表示将 stamp_page 作为底层（即置于原页面下方），
        # 但因 stamp 是纯文本+透明背景，视觉上显示在顶部；
        # 若需真正“浮于上方”，可设 over=True 并调整 stamp PDF 的坐标（见进阶提示）
        page.merge_page(stamp_page, over=False)

    writer.write(out_path)


# 示例调用：为 GeoTopo.pdf 每页顶部添加指向官网的链接
if __name__ == "__main__":
    overlay_pdf = "header_link.pdf"
    generate_overlay(overlay_pdf, "Go to Documentation", "https://py-pdf.github.io")
    stamp("GeoTopo.pdf", overlay_pdf, "GeoTopo_with_link.pdf")

⚠️ 关键注意事项

over=False 的语义：pypdf 中 merge_page(..., over=False) 表示将 stamp 页面“绘制在当前页下方”，但由于我们生成的 stamp PDF 是空白背景 + 文本（无填充），实际视觉效果是文字“悬浮”在原页面顶部；若需更精确控制位置（如距顶 10pt、右对齐），建议在 generate_overlay 中使用 self.set_xy() 显式定位，而非依赖 header()。
字体嵌入与兼容性：fpdf2 默认使用 helvetica（标准 PDF 字体），无需嵌入，保证输出 PDF 在任意阅读器中均可点击；如需自定义字体（如中文字体），需显式 add_font() 并设置 set_font(..., uni=True)。
动态链接支持：generate_overlay() 可轻松扩展为接收文档元数据列表，循环生成不同链接（如 f"View parent: {doc_id}" → f"https://site.com/docs/{doc_id}"），实现 per-document 定制化。
避免 PDF 损坏：旧版 PyPdf2 的 mergePage 已弃用；务必使用 pypdf>=4.0 的 merge_page()，且 clone_from= 初始化 PdfWriter 是安全合并的前提——它完整继承源文件结构（书签、元数据、加密状态等）。