PdfMerger比PdfWriter更适合合并PDF，因其专为合并设计，自动处理页码偏移、书签继承和资源复用，保留大纲、缩略图等元数据，而PdfWriter仅逐页写入且不保留这些信息。
为什么 PdfMerger 比 PdfWriter 更适合合并 PDF
PyPDF2 从 3.0.0 版本起弃用了 PdfFileMerger，推荐用 PdfMerger；它专为合并设计，内部自动处理页码偏移、书签继承和页面资源复用，比手动用 PdfWriter 添加页面更可靠。如果你用旧教程里的 PdfFileMerger，会直接报 NameError: name 'PdfFileMerger' is not defined。
常见错误是误以为 PdfWriter 能“追加”文件——它只能逐页写入，不保留原 PDF 的大纲、缩略图、表单域等元数据，而 PdfMerger 默认保留（除非显式关闭）。
- 必须用
pip install PyPDF2>=3.0.0，低于该版本没有PdfMerger -
PdfMerger不接受文件路径字符串，只接受已打开的file对象或BytesIO流 - 合并后默认不压缩对象，输出体积可能略大，但可读性和兼容性更好
合并多个本地 PDF 文件的标准流程
核心是按顺序调用 append()，不是 merge()（后者用于插入到指定位置）。顺序决定最终页码排列，且每个文件需单独 open() 并保持打开状态直到 close() 或上下文退出。
from PyPDF2 import PdfMerger
<p>merger = PdfMerger()
for pdf_path in ["a.pdf", "b.pdf", "c.pdf"]:
with open(pdf_path, "rb") as f:
merger.append(f) # 注意：传入的是 file 对象，不是字符串
merger.write("merged.pdf")
merger.close()</p>
- 所有文件必须以
"rb"模式打开，二进制读取是硬性要求 - 不要在循环外提前
open()所有文件再传入——容易触发系统文件句柄数限制 - 如果某个 PDF 加密，
append()会抛PyPDF2.errors.FileNotDecryptedError，需先用decrypt()
合并时跳过加密 PDF 或自动解密
遇到带密码的 PDF，append() 会立即失败，不会等到 write()。不能靠 try/except 吞掉错误后继续——后续 append() 仍会失败，因为 PdfMerger 内部状态已损坏。
正确做法是在 append() 前预判并解密：
from PyPDF2 import PdfReader, PdfMerger
<p>merger = PdfMerger()
for pdf_path in ["locked.pdf", "normal.pdf"]:
reader = PdfReader(pdf_path)
if reader.is_encrypted:</p><h1>尝试空密码或已知密码</h1><pre class="brush:python;toolbar:false;"> if reader.decrypt("") == 0: # 返回 0 表示解密失败
raise ValueError(f"Cannot decrypt {pdf_path} with empty password")
# 解密成功后，用 reader.stream（即原始 file-like 对象）重新构造可读流
with open(pdf_path, "rb") as f:
merger.append(f)
-
PdfReader(pdf_path)会自动尝试用空密码解密，但不改变原文件打开方式 - 解密后不能直接把
PdfReader对象传给append()，仍得用原始open()的文件对象 - 如果密码未知，PyPDF2 不支持暴力破解，此时应中断流程或记录日志
合并后保留书签但避免重复层级
PdfMerger 默认将每个被合并文件的顶层书签作为新文档的一级书签，但若源 PDF 本身有多级书签，它们会被整体平移嵌套——这通常符合预期。唯一容易出问题的是：当多个 PDF 都有同名书签（如都叫“封面”），合并后会出现重名节点，PDF 阅读器可能忽略部分。
- 用
merger.append(f, outline=False)可彻底禁用该文件的书签导入 - 若要重命名书签，必须在
append()后立刻操作merger.outline列表，但该列表是只读结构，实际需用add_outline_item()手动重建 - 书签目标页码由
PdfMerger自动修正，无需手动计算偏移量——这是它比手写逻辑最大的优势
真正难处理的是含 JavaScript 表单或数字签名的 PDF：合并会直接破坏签名，且 PyPDF2 不支持提取/迁移表单字段。这类文件建议仅作物理拼接，勿期望功能完整保留。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
