無程式碼也能輕鬆打造專業LINE官方帳號！一鍵導入模板，讓AI助你行銷加分！
当你在 Python 中操作 PDF 而不需要大量外部依赖时，pypdf 是首选解决方案。这个纯 Python 库提供了全面的 PDF 操作能力，包括分割、合并、裁剪、旋转、加密和文字提取，全部无需任何原生代码或系统库。
Pypdf 作为标准的 Python PDF 库已有超过十年的历史。它经历了多个主要版本的演进，现在提供了一个干净、现代的 API，易于使用同时在底层又非常强大。该库直接解析 PDF 规范，因此可以访问文档结构中的每个元素。
核心能力
| 功能 | 描述 | API |
|---|---|---|
| 页面操作 | 合并、分割、旋转、缩放、裁剪 | PdfWriter + PdfReader |
| 元数据 | 读取和写入文档元数据 | metadata 属性 |
| 加密 | PDF 密码保护和解密 | encrypt() / decrypt() |
| 文字提取 | 从页面中提取文字，附带版面选项 | extract_text() |
| 表格填写 | 填写 PDF AcroForm 字段 | update_page_form_field_values() |
文档处理流程
flowchart LR
A[输入 PDF] --> B[PdfReader]
B --> C{操作类型}
C -->|合并| D[PdfWriter.append]
C -->|分割| E[每页 PdfWriter]
C -->|变换| F[页面变换]
C -->|提取| G[text_extraction]
D --> H[PdfWriter]
E --> H
F --> H
G --> H
H --> I[write() 至文件]工作流程围绕着用于输入的 PdfReader 和用于输出的 PdfWriter。页面被读取、操作并组装成新文档。文字提取绕过 Writer 路径，直接返回字符串。
库比较
| 功能 | pypdf | PyMuPDF | pdfminer.six | pdfplumber |
|---|---|---|---|---|
| 纯 Python | 是 | 否（C 绑定） | 是 | 是 |
| 安装 | pip install | 复杂原生依赖 | pip install | pip install |
| 页面操作 | 完整 | 有限 | 无 | 无 |
| 加密 | 完整 | 完整 | 部分 | 无 |
| 性能 | 中等 | 非常快 | 慢 | 中等 |
纯 Python 的重要性
pypdf 的纯 Python 特性使其非常适合无服务器环境和 CI/CD 管线，在这些环境中安装原生库很困难。它在 Python 支持的每个平台上都能工作，从 Raspberry Pi 到大型主机，无需编译步骤。对于依赖管理至关重要的部署场景，pypdf 的零原生依赖方法是一个显著优势。
如需更多信息，请访问 pypdf GitHub 仓库 和 pypdf 文档。
常见问题
Q：pypdf 支持哪些 Python 版本？ A：pypdf 支持 Python 3.8 及以上版本，包括 Python 3.13。
Q：pypdf 可以从 PDF 中提取图像吗？ A：它有基本的图像提取功能；对于高级图像处理，建议使用 PyMuPDF。
Q：pypdf 是线程安全的吗？ A：是的，PdfReader 实例对于读取操作是线程安全的。
Q：pypdf 能处理 PDF/A 文档吗？ A：它可以读取 PDF/A 文档，但不会验证或创建符合 PDF/A 的输出。
Q：pypdf 与 PyPDF2/PyPDF3/PyPDF4 相比如何？ A：pypdf 是 PyPDF2 的直接继承者，也是原始 py-pdf 项目的主动维护版本。
