pypdf完全指南：从安装到PDF合并、拆分与转换的终极教程

pypdf完全指南：从安装到PDF合并、拆分与转换的终极教程

【免费下载链接】pypdfA pure-python PDF library capable of splitting, merging, cropping, and transforming the pages of PDF files项目地址: https://gitcode.com/gh_mirrors/py/pypdf

pypdf是一个强大的纯Python PDF处理库，能够实现PDF文件的拆分、合并、裁剪和页面转换等核心功能。无论是日常办公还是开发需求，掌握pypdf都能让你轻松应对各种PDF处理任务，无需依赖复杂的商业软件。

快速上手：pypdf的安装与基础配置

一键安装步骤

安装pypdf非常简单，只需使用pip命令即可完成：

pip install pypdf

如果你需要从源码安装最新开发版本，可以克隆仓库后进行本地安装：

git clone https://gitcode.com/gh_mirrors/py/pypdf cd pypdf pip install .

验证安装是否成功

安装完成后，你可以通过导入pypdf并查看版本来验证安装是否成功：

import pypdf print(pypdf.__version__)

PDF合并：将多个文件无缝拼接

PDF合并是pypdf最常用的功能之一，无论是合并多个文档还是整理扫描件，都能轻松完成。

基础合并方法

使用pypdf的PdfMerger类可以快速合并多个PDF文件：

from pypdf import PdfMerger merger = PdfMerger() merger.append("file1.pdf") merger.append("file2.pdf") merger.write("merged.pdf") merger.close()

高级合并技巧

pypdf支持更灵活的合并操作，如指定页面范围、旋转页面等。下面是一个合并并旋转页面的示例：

上图展示了基本的PDF合并效果，每个页面保持原始方向和大小。如果你需要对页面进行旋转，可以使用如下代码：

from pypdf import PdfMerger merger = PdfMerger() merger.append("file1.pdf", pages=(0, 1)) # 只合并第一页 merger.append("file2.pdf", rotation=45) # 旋转45度 merger.write("merged_rotated.pdf") merger.close()

PDF拆分：提取你需要的页面

除了合并，pypdf也能轻松实现PDF文件的拆分，提取特定页面或页面范围。

按页面范围拆分

使用PdfReader和PdfWriter可以实现PDF的拆分功能：

from pypdf import PdfReader, PdfWriter reader = PdfReader("input.pdf") writer = PdfWriter() # 提取第2-4页（注意页码从0开始） for page in reader.pages[1:4]: writer.add_page(page) with open("output.pdf", "wb") as f: writer.write(f)

批量拆分多个页面

如果你需要将一个PDF拆分为多个单页PDF，可以使用以下方法：

from pypdf import PdfReader reader = PdfReader("input.pdf") for i, page in enumerate(reader.pages): writer = PdfWriter() writer.add_page(page) with open(f"page_{i+1}.pdf", "wb") as f: writer.write(f)

PDF转换：缩放、旋转与页面布局调整

pypdf提供了丰富的页面转换功能，可以满足各种布局调整需求。

页面缩放与调整

使用Transformation类可以对PDF页面进行缩放和变换：

上图展示了不同缩放方式的效果对比，包括原始大小、内容缩放和页面缩放。以下是实现页面缩放的代码示例：

from pypdf import PdfReader, PdfWriter from pypdf.transformations import Transformation reader = PdfReader("input.pdf") writer = PdfWriter() page = reader.pages[0] # 缩小页面至50% page.add_transformation(Transformation().scale(0.5)) writer.add_page(page) with open("scaled.pdf", "wb") as f: writer.write(f)

页面旋转与平移

pypdf支持对页面进行旋转和位置调整，以满足不同的排版需求：

上图展示了旋转并扩展页面的效果。以下是实现页面旋转和平移的代码：

from pypdf import PdfReader, PdfWriter from pypdf.transformations import Transformation reader = PdfReader("input.pdf") writer = PdfWriter() page = reader.pages[0] # 旋转30度并向右平移100点 page.add_transformation(Transformation().rotate(30).translate(100, 0)) writer.add_page(page) with open("transformed.pdf", "wb") as f: writer.write(f)

实用功能：添加水印与创建目录

添加水印保护文档

pypdf可以轻松为PDF添加水印，保护你的文档版权：

以下是添加文本水印的代码示例：

from pypdf import PdfReader, PdfWriter from pypdf.generic import AnnotationBuilder reader = PdfReader("input.pdf") writer = PdfWriter() for page in reader.pages: # 添加水印注释 annotation = AnnotationBuilder.free_text( "CONFIDENTIAL", rect=(50, 500, 200, 600), font_size=24, color=(1, 0, 0), # 红色 rotation=45, ) page.add_annotation(annotation) writer.add_page(page) with open("watermarked.pdf", "wb") as f: writer.write(f)

创建PDF目录

使用pypdf可以为PDF文档创建交互式目录，提升文档的可读性：

以下是创建PDF目录的代码示例：

from pypdf import PdfReader, PdfWriter reader = PdfReader("input.pdf") writer = PdfWriter() # 添加所有页面 for page in reader.pages: writer.add_page(page) # 创建目录 writer.add_outline_item("Introduction", 0) # 第一页 writer.add_outline_item("Chapter 1", 1) # 第二页 with writer.add_outline_item("Section 1.1", 2) as subitem: subitem.add_outline_item("Subsection 1.1.1", 3) with open("outlined.pdf", "wb") as f: writer.write(f)

总结与进阶学习

通过本教程，你已经掌握了pypdf的基本用法，包括PDF的合并、拆分、转换等核心功能。pypdf的功能远不止于此，你还可以探索更多高级特性：

• 文档加密与解密
• 提取PDF文本与图片
• 处理PDF表单
• PDF/A合规转换

pypdf的源代码结构清晰，主要功能实现位于以下模块：

• PDF读取：pypdf/_reader.py
• PDF写入：pypdf/_writer.py
• 页面操作：pypdf/_page.py
• 转换功能：pypdf/transformations.py

无论你是需要处理日常PDF任务，还是开发PDF相关应用，pypdf都是一个值得深入学习的强大工具。开始探索吧，释放PDF处理的无限可能！

【免费下载链接】pypdfA pure-python PDF library capable of splitting, merging, cropping, and transforming the pages of PDF files项目地址: https://gitcode.com/gh_mirrors/py/pypdf