Python 实战指南:一键批量旋转 PDF 页面方向

在日常办公、文档处理或自动化流程中,我们经常会遇到 PDF 页面方向错误的问题------比如扫描件横置、部分页面倒置,或者从不同来源合并的 PDF 页向不统一。手动用 Adobe Acrobat 或其他工具逐页调整既耗时又低效。

幸运的是,借助 Python 和开源库 PyPDF2 (或其继任者 pypdf ),我们可以几行代码轻松实现 PDF 页面的自动旋转,甚至支持批量处理!本文将带你从零开始,完成一个实用的 PDF 页面方向调整脚本。


一、准备工作:安装依赖

推荐使用 pypdf(PyPDF2 的现代维护版本,性能更好、API 更清晰):

复制代码
pip install pypdf

💡 注意:如果你仍在使用旧版 PyPDF2,大部分代码也兼容,但建议迁移到 pypdf。


二、核心原理:PDF 页面的旋转机制

在 PDF 中,每个页面都有一个 /Rotate 属性,表示顺时针旋转角度,必须是 90 的整数倍(如 0、90、180、270)。

  • 0:正常方向
  • 90:向右旋转 90°(横屏)
  • 180:倒置
  • 270:向左旋转 90°

通过修改该属性,即可无损调整页面显示方向,无需重新渲染图像或内容。


三、基础示例:旋转指定页面

以下代码将 PDF 的第 1 页(索引 0)顺时针旋转 90°:

复制代码
from pypdf import PdfReader, PdfWriter

def rotate_page(input_pdf, output_pdf, page_number, rotation=90):
    reader = PdfReader(input_pdf)
    writer = PdfWriter()

    for i, page in enumerate(reader.pages):
        if i == page_number:
            page.rotate(rotation)  # 旋转角度(90, 180, 270)
        writer.add_page(page)

    with open(output_pdf, "wb") as f:
        writer.write(f)

# 使用示例:旋转第1页(索引0)90度
rotate_page("input.pdf", "output_rotated.pdf", page_number=0, rotation=90)

✅ page.rotate() 会累加旋转角度。若页面原本是 90°,再调用 rotate(90) 将变为 180°。

如需强制设为某个方向 ,可先重置为 0:page.rotate(-page.get("/Rotate", 0)),再设置新值。


四、进阶实战:批量处理所有页面

场景 1:将整个 PDF 所有页面统一旋转 180°(如全部倒置的扫描件)
复制代码
def rotate_all_pages(input_pdf, output_pdf, rotation=180):
    reader = PdfReader(input_pdf)
    writer = PdfWriter()

    for page in reader.pages:
        page.rotate(rotation)
        writer.add_page(page)

    with open(output_pdf, "wb") as f:
        writer.write(f)

rotate_all_pages("scanned.pdf", "corrected.pdf", rotation=180)
场景 2:智能检测并修正"横置"页面(假设奇数页应为纵向,偶数页为横向)
复制代码
def smart_rotate_by_index(input_pdf, output_pdf):
    reader = PdfReader(input_pdf)
    writer = PdfWriter()

    for i, page in enumerate(reader.pages):
        if i % 2 == 1:  # 偶数页(索引从0开始)
            # 如果当前未旋转,则设为90度
            current_rot = page.get("/Rotate", 0)
            if current_rot == 0:
                page.rotate(90)
        writer.add_page(page)

    with open(output_pdf, "wb") as f:
        writer.write(f)

五、实用工具函数:命令行调用

将脚本封装为命令行工具,方便日常使用:

复制代码
# pdf_rotate.py
import argparse
from pypdf import PdfReader, PdfWriter

def main():
    parser = argparse.ArgumentParser(description="旋转 PDF 页面方向")
    parser.add_argument("input", help="输入 PDF 文件路径")
    parser.add_argument("output", help="输出 PDF 文件路径")
    parser.add_argument("--angle", type=int, default=90, choices=[90, 180, 270], help="旋转角度")
    parser.add_argument("--page", type=int, help="指定页码(从1开始),不填则旋转所有页")

    args = parser.parse_args()

    reader = PdfReader(args.input)
    writer = PdfWriter()

    for i, page in enumerate(reader.pages):
        if args.page is None or i == args.page - 1:
            page.rotate(args.angle)
        writer.add_page(page)

    with open(args.output, "wb") as f:
        writer.write(f)

    print(f"✅ 已保存至: {args.output}")

if __name__ == "__main__":
    main()

使用方式:

复制代码
# 旋转第3页 270度
python pdf_rotate.py input.pdf output.pdf --page 3 --angle 270

# 全部页面旋转180度
python pdf_rotate.py input.pdf output.pdf --angle 180

六、注意事项与局限

  1. 仅修改元数据,不重绘内容:旋转是"视图级"操作,不影响原始文本或图像数据。
  2. 角度必须是 90 的倍数 :否则 rotate() 会报错。
  3. 加密 PDF 需先解密 :pypdf 支持读取带密码的 PDF(reader.decrypt("password")),但无法修改加密文件。
  4. 保留书签与注释 :上述方法默认会丢失书签(outlines)。如需保留,需额外处理(writer.add_outline_item())。

结语

通过 Python + pypdf,我们不仅解决了 PDF 页面方向问题,还构建了一个可复用、可扩展的文档处理工具。无论是个人整理资料,还是集成到企业自动化流程中,这类脚本都能显著提升效率。

🌟 小提示 :结合 watchdog 库,你甚至可以实现"监控文件夹,自动修正新放入的 PDF 方向"!

从此,再也不用手动一页页拖拽旋转------让代码为你打工!

相关推荐
ShineWinsu1 小时前
对于Qt:QFormLayout常见属性以及方法的解析
开发语言·c++·qt·面试·客户端·表单·qformlayout
Thanks_ks1 小时前
Python 的垃圾回收——引用计数撑起日常,分代回收收拾残局
python·内存管理·垃圾回收·循环引用·引用计数·gc 模块·weakref
CyrusYiVPP2 小时前
实测 uv 0.13.7:同一套包,pip 装 94 秒,它只用 19 秒
人工智能·python
yiangL_2 小时前
Python 学习笔记:递归、turtle绘图、字符串与函数
笔记·python·学习
lula8883 小时前
PVC-U、PVC-C、PVC-O 差一个字母,差的是三种增强路线
python
数字工作台4 小时前
给 LangGraph 加一道可审计记忆:替换默认 Checkpointer,实现防篡改 + 崩溃不丢数据
python·agent
DKPT5 小时前
Python 的 Web 框架:选型选错的人,都踩了同一个坑
python
2401_868534785 小时前
逻辑网络设计
网络·python
2601_967979126 小时前
python如何组织文件?python文件操作全介绍!
python·文件操作·压缩文件·遍历文件夹·shutil模块
青少儿编程课堂6 小时前
蓝桥杯·全国青少年信息素养大赛·电子学会Python/C++考级:扫描线与线段树求矩形面积并解析
c++·python·算法·bfs·信息学竞赛