PyPDF2中rotateClockwise()不生效是因为它就地修改PageObject但不自动保存,需在add_page前调用且合并时要同步更新mediabox以避免裁切,加密PDF须先解密。

PyPDF2 旋转单页时为什么 rotateClockwise() 不生效?
因为 rotateClockwise() 和 rotateCounterClockwise() 是就地修改方法,但它们**不返回新页面对象,也不自动保存到 PDF 文件中**;你必须显式调用 write() 才能持久化。更关键的是:这些方法操作的是 PdfReader.pages[i] 返回的 PageObject 实例,而该实例在被添加进 PdfWriter 时是浅拷贝——如果先旋转再 add_page,没问题;但如果先 add_page 再试图从 writer 中取页旋转,就无效(writer 里的页已是副本)。
正确做法始终是:在 add_page 前对 PageObject 调用旋转方法:
from PyPDF2 import PdfReader, PdfWriter
<p>reader = PdfReader("input.pdf")
writer = PdfWriter()</p><p>for page in reader.pages:
page.rotateClockwise(90) # 直接修改原 page 对象
writer.add_page(page)
合并多个 PDF 并按文件顺序统一旋转某角度
常见需求是把若干 PDF 按目录顺序拼成一个文件,且所有页面顺时针转 90°。注意两点:不同 PDF 的页面可能已有旋转属性(page.get("/Rotate")),叠加旋转会出错;PyPDF2 默认不继承源页的 /Rotate 字典项,所以手动旋转后它不会“叠加”,而是覆盖。
- 用
os.listdir()或glob.glob()获取 PDF 文件列表,确保排序符合预期(例如加sorted()) - 对每个文件的每一页,先读取再调用
rotateClockwise(90),再 add_page - 不要依赖
page.mediabox高宽判断是否需要旋转——PDF 页面坐标系和显示旋转是两回事,/Rotate 才是渲染依据
合并时页面尺寸不一致导致内容被裁切怎么办?
PyPDF2 合并时不会自动缩放或重排页面,所有页面保持原始 mediabox 尺寸。如果你发现某些页文字被截断,大概率是因为旋转后页面宽高互换,但阅读器仍按原 mediabox 渲染(比如 A4 竖页旋转 90° 后逻辑上应为横版,但 mediabox 没变,导致右侧被裁)。
立即学习“Python免费学习笔记(深入)”;
解决方法是:旋转后手动更新 mediabox:
当现有的脚本或服务需要将作用域化的仓库工作委托给 Claude Code 并以编程方式消费结构化响应时,请使用 Claude Agent SDK for Python。
from PyPDF2.generic import RectangleObject <p>for page in reader.pages: page.rotateClockwise(90)</p><h1>交换宽高:原 (x0,y0,x1,y1) → 新 (y0,x0,y1,x1)</h1><pre class="brush:php;toolbar:false;">mb = page.mediabox page.mediabox = RectangleObject([mb[1], mb[0], mb[3], mb[2]]) writer.add_page(page)
注意:RectangleObject 的坐标顺序是 [x0, y0, x1, y1],旋转 90° 后左下角变成左上角,所以需交换 x/y 范围。
PyPDF2 2.12+ 版本中 rotateClockwise() 的参数变化
旧版 PyPDF2(如 1.x)只接受 90/180/270;2.12+ 支持任意整数度数(如 rotateClockwise(45)),但实际效果取决于 PDF 查看器是否支持非标准旋转——多数阅读器只识别 0/90/180/270,其余会被忽略或四舍五入。因此生产环境建议坚持用 90 的倍数。
另外,rotateClockwise() 底层是设置 /Rotate 字典项,不是图像重绘,所以不损失清晰度,但也不会改变文本流向或重排文字框。
真正容易被忽略的是:如果你合并的 PDF 中有加密(password protected),PdfReader 必须先用 reader.decrypt("pwd") 解密,否则 pages 可能为空或抛 NotDecryptedError——这个错误不总明显报出,有时静默失败。


















