处理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方向的效率会明显提升。
