使用Python旋转PDF页面的多种方法与实用技巧教程

处理PDF时，页面方向不对是个老生常谈的问题。扫描件放倒了、多个来源合并的PDF方向不统一……这些都需要旋转来摆正。用程序自动化旋转，能一键处理成百上千个文件，效率和一致性都上去了。

下面就来聊聊如何用 Spire.PDF for Python 搞定旋转。会涉及创建新PDF时设置方向、旋转现有页面、批量处理等场景，基本覆盖日常使用需求。

环境准备

先装好库，一条命令搞定：

pip install Spire.PDF

装完就能在项目里调用了。

PDF 页面旋转的应用场景

实际工作中，页面旋转的典型场景还真不少：

• 扫描文档校正：修正扫描时方向错误的页面
• 文档合并前的预处理：统一多个 PDF 文件的页面方向
• 横向内容展示：将包含宽表格或图表的页面旋转为横向显示
• 阅读体验优化：根据内容特点调整页面方向以提升可读性
• 打印准备：确保 PDF 页面方向与打印机设置匹配
• 批量处理：自动化处理大量方向不一致的 PDF 文档

Spire.PDF for Python 提供了两种主要途径：创建新PDF时直接设好旋转，或者对已有的PDF页面进行旋转。两种方式灵活搭配，基本能满足不同场景的需求。

创建新 PDF 时设置页面旋转

如果是从零生成PDF，可以在创建时就指定页面的旋转属性。直接看代码：

from spire.pdf.common import *
from spire.pdf import *

def RotatePageWhenCreatingNewPDF():
    """创建新 PDF 时设置页面旋转"""
    outputFile = "/RotateNewPDF.pdf"
    
    # 创建 PDF 文档对象
    doc = PdfDocument()
    
    # 创建单位转换器，用于转换度量单位
    unitCvtr = PdfUnitConvertor()
    
    # 设置页面边距
    margin = PdfMargins()
    margin.Top = unitCvtr.ConvertUnits(
        2.54, PdfGraphicsUnit.Centimeter, PdfGraphicsUnit.Point)
    margin.Bottom = margin.Top
    margin.Left = unitCvtr.ConvertUnits(
        2.0, PdfGraphicsUnit.Centimeter, PdfGraphicsUnit.Point)
    margin.Right = margin.Left
    
    # 添加一个新的节（Section）
    section = doc.Sections.Add()
    
    # 设置页面大小为 A4
    section.PageSettings.Size = PdfPageSize.A4()
    
    # 设置页面边距
    section.PageSettings.Margins = margin
    
    # 设置页面旋转角度为 90 度
    section.PageSettings.Rotate = PdfPageRotateAngle.RotateAngle90
    
    # 添加页面
    page = section.Pages.Add()
    
    # 定义画刷和字体
    brush = PdfBrushes.get_Black()
    font = PdfTrueTypeFont("Arial", 13.0, PdfFontStyle.Bold, True)
    
    # 设置文本格式
    format = PdfStringFormat(PdfTextAlignment.Left)
    
    # 设置绘制位置
    x = 0.0
    y = 50.0
    
    # 定义文本内容
    specification = "如何在创建 PDF 时设置页面旋转"
    
    # 在页面上绘制文本
    page.Canvas.DrawString(specification, font, brush, x, y, format)
    
    # 保存文档
    doc.Sa veToFile(outputFile)
    doc.Close()
    
    print(f"带旋转设置的 PDF 已保存至: {outputFile}")

if __name__ == "__main__":
    RotatePageWhenCreatingNewPDF()

核心就是 section.PageSettings.Rotate 这一行。PdfPageRotateAngle 枚举提供了四个选项：RotateAngle0（不旋转）、RotateAngle90（顺时针90度）、RotateAngle180（顺时针180度）、RotateAngle270（顺时针270度）。

这种方式的优点是旋转在页面生成时就定好了，输出的PDF直接就是想要的方向，非常适合生成固定方向的报表、证书等标准化文档。

旋转现有 PDF 文件的页面

更多时候需要处理的是已有的PDF。下面这个例子演示加载文档并旋转指定页面：

from spire.pdf.common import *
from spire.pdf import *

# 创建一个 PdfDocument 对象用于处理 PDF 文件
pdf = PdfDocument()

# 从指定文件路径加载 PDF 文档
pdf.LoadFromFile("/AI绘画的利与弊.pdf")

# 获取第一页的页面对象
page = pdf.Pages.get_Item(0)

# 获取当前页面的旋转角度并转换为对应的整数值
rotation = int(page.Rotation.value)

# 将旋转角度增加 180 度
rotation += int(PdfPageRotateAngle.RotateAngle180.value)

# 如果旋转角度达到 360 度（4个值），则重置为 0 度
if rotation == 4:
    rotation = 0

# 设置页面的旋转角度为新的值
page.Rotation = PdfPageRotateAngle(rotation)

# 将修改后的 PDF 文档保存到文件
pdf.Sa veToFile("/output/旋转特定页面.pdf")
pdf.Close()

流程很清晰：先加载PDF，然后用索引拿到目标页面，读取当前的旋转数值，累加上要旋转的角度（这里是180度），如果超过了360度就模一下回到0，最后把新值赋给page.Rotation并保存。

这种累加方式的好处是能保留原有的旋转设置，只做增量调整。比如页面原本已旋转了90度，再转270度，最终效果就是回到原始方向。

实用技巧与高级应用

批量旋转所有页面

实际项目中不会只转一页，更多是处理整个文档。下面封装了一个工具类，把常用旋转操作集中起来：

from spire.pdf.common import *
from spire.pdf import *
import os

class PDFRotationManager:
    """PDF 页面旋转管理器"""
    
    def __init__(self, input_file):
        """初始化并加载 PDF 文档"""
        self.doc = PdfDocument()
        self.doc.LoadFromFile(input_file)
        self.input_file = input_file
    
    def rotate_all_pages(self, rotation_angle):
        """旋转所有页面"""
        page_count = self.doc.Pages.Count
        
        for i in range(page_count):
            page = self.doc.Pages[i]
            
            # 获取当前旋转角度
            current_rotation = int(page.Rotation.value)
            
            # 计算新的旋转角度
            new_rotation = current_rotation + int(rotation_angle.value)
            
            # 应用新的旋转角度
            page.Rotation = PdfPageRotateAngle(new_rotation)
        
        print(f"已旋转所有 {page_count} 个页面")
        return page_count
    
    def rotate_specific_pages(self, page_indices, rotation_angle):
        """旋转指定的页面"""
        rotated_count = 0
        
        for index in page_indices:
            if 0 <= index < self.doc.Pages.Count:
                page = self.doc.Pages[index]
                
                # 获取当前旋转角度
                current_rotation = int(page.Rotation.value)
                
                # 计算新的旋转角度
                new_rotation = current_rotation + int(rotation_angle.value)
                
                # 应用新的旋转角度
                page.Rotation = PdfPageRotateAngle(new_rotation)
                
                rotated_count += 1
        
        print(f"已旋转 {rotated_count} 个指定页面")
        return rotated_count
    
    def rotate_pages_by_condition(self, condition_func, rotation_angle):
        """根据条件函数旋转页面"""
        rotated_count = 0
        page_count = self.doc.Pages.Count
        
        for i in range(page_count):
            page = self.doc.Pages[i]
            
            # 调用条件函数判断是否需要旋转
            if condition_func(i, page):
                current_rotation = int(page.Rotation.value)
                new_rotation = current_rotation + int(rotation_angle.value)
                page.Rotation = PdfPageRotateAngle(new_rotation)
                rotated_count += 1
        
        print(f"已根据条件旋转 {rotated_count} 个页面")
        return rotated_count
    
    def get_page_info(self):
        """获取所有页面的旋转信息"""
        info = []
        
        for i in range(self.doc.Pages.Count):
            page = self.doc.Pages[i]
            rotation = int(page.Rotation.value)
            info.append({
                'page_index': i,
                'rotation': rotation,
                'rotation_label': self._get_rotation_label(rotation)
            })
        
        return info
    
    def _get_rotation_label(self, rotation_value):
        """获取旋转角度的标签"""
        if rotation_value % 360 == 0:
            return "0° (正常)"
        elif rotation_value % 360 == 90:
            return "90° (顺时针)"
        elif rotation_value % 360 == 180:
            return "180° (倒置)"
        elif rotation_value % 360 == 270:
            return "270° (逆时针)"
        else:
            return f"{rotation_value % 360}°"
    
    def sa ve(self, output_file=None):
        """保存文档"""
        if output_file is None:
            output_file = self.input_file
        
        self.doc.Sa veToFile(output_file)
        self.doc.Close()
        print(f"文件已保存至: {output_file}")

def main():
    input_file = "./Demos/Data/Sample.pdf"
    
    # 创建旋转管理器
    manager = PDFRotationManager(input_file)
    
    # 查看当前页面旋转信息
    page_info = manager.get_page_info()
    for info in page_info:
        print(f"页面 {info['page_index']}: 旋转角度 = {info['rotation_label']}")
    
    # 示例 1: 旋转所有页面 90 度
    manager.rotate_all_pages(PdfPageRotateAngle.RotateAngle90)
    manager.sa ve("./Output/Rotated_All_90.pdf")
    
    # 重新加载以演示其他功能
    manager2 = PDFRotationManager(input_file)
    
    # 示例 2: 旋转指定页面（第 1、3、5 页）
    manager2.rotate_specific_pages(
        [0, 2, 4], 
        PdfPageRotateAngle.RotateAngle180
    )
    manager2.sa ve("./Output/Rotated_Specific.pdf")
    
    # 示例 3: 根据条件旋转（例如，只旋转偶数页）
    manager3 = PDFRotationManager(input_file)
    manager3.rotate_pages_by_condition(
        lambda index, page: index % 2 == 0,  # 偶数页条件
        PdfPageRotateAngle.RotateAngle90
    )
    manager3.sa ve("./Output/Rotated_Even.pdf")

if __name__ == "__main__":
    main()

这个类封装了旋转所有页、旋转指定页、按条件旋转三种功能，还附带页面信息查询。拿来即用，多场景覆盖。

常见应用场景示例

场景 1：修正扫描文档的方向

def FixScannedDocument():
    """修正扫描文档的页面方向"""
    # 假设扫描的文档所有页面都逆时针旋转了 90 度
    manager = PDFRotationManager("./Scans/ScannedDoc.pdf")
    
    # 将所有页面顺时针旋转 90 度以修正
    manager.rotate_all_pages(PdfPageRotateAngle.RotateAngle90)
    manager.sa ve("./Output/FixedScan.pdf")

场景 2：混合方向文档处理

def HandleMixedOrientation():
    """处理包含横向和纵向页面的混合文档"""
    manager = PDFRotationManager("./Data/MixedDoc.pdf")
    
    # 假设第 2、4、6 页是横向内容，需要旋转 90 度
    manager.rotate_specific_pages(
        [1, 3, 5],  # 页面索引从 0 开始
        PdfPageRotateAngle.RotateAngle90
    )
    manager.sa ve("./Output/FixedMixed.pdf")

场景 3：批量处理文件夹中的所有 PDF

def BatchRotateFolder():
    """批量旋转文件夹中的所有 PDF 文件"""
    import glob
    
    input_folder = "./Input_PDFs"
    output_folder = "./Rotated_PDFs"
    
    # 创建输出文件夹
    if not os.path.exists(output_folder):
        os.makedirs(output_folder)
    
    # 查找所有 PDF 文件
    pdf_files = glob.glob(os.path.join(input_folder, "*.pdf"))
    
    print(f"找到 {len(pdf_files)} 个 PDF 文件")
    
    for pdf_file in pdf_files:
        filename = os.path.basename(pdf_file)
        output_file = os.path.join(output_folder, filename)
        
        manager = PDFRotationManager(pdf_file)
        manager.rotate_all_pages(PdfPageRotateAngle.RotateAngle90)
        manager.sa ve(output_file)
        
        print(f"已处理: {filename}")
    
    print("批量处理完成")

可用的旋转角度

Spire.PDF 提供了四个标准角度：

• PdfPageRotateAngle.RotateAngle0：不旋转（0 度）
• PdfPageRotateAngle.RotateAngle90：顺时针旋转 90 度
• PdfPageRotateAngle.RotateAngle180：顺时针旋转 180 度
• PdfPageRotateAngle.RotateAngle270：顺时针旋转 270 度

注意旋转是累加的，多次设置会在原有基础上继续加。所以最好先看看当前旋转状态，再决定怎么加。

最佳实践与注意事项

性能优化建议

• 批量处理时及时释放资源：每个文件处理完记得调用 Close()
• 避免不必要的重复加载：同一个文件多次操作，尽量一次加载完成
• 大文件注意内存：页面多的PDF，可以考虑分批处理

旋转角度计算

• 理解累加机制：每次旋转都是在当前基础上叠加
• 使用模运算：通过 % 360 可以把角度归一化到 0-359 范围
• 预览效果：重要文档先拿小样本试一下

常见问题与解决方案

问题 1：旋转后页面内容被裁剪

解决方法：确保旋转角度是90的倍数，页面尺寸设置正确。部分阅读器可能需要重新刷新才能正确显示。

问题 2：旋转不起作用

解决方法：检查是否调用了 Sa veToFile() 并确认旋转角度值有效。

问题 3：批量处理后文件损坏

解决方法：每个文件处理完正确调用 Close() 释放资源，避免文件被锁定。

总结

上面我们聊了用 Spire.PDF for Python 旋转 PDF 页面的几种方式。创建新文档时用 section.PageSettings.Rotate 设定方向，处理现有文档则通过 page.Rotation 属性累加角度，再加上条件旋转和批量封装的工具，基本覆盖了扫描件校正、文档合并预处理等常见场景。掌握这些，自动化处理PDF方向的效率会明显提升。