當我們在處理PDF文檔時，經常會遇到頁面方向不正確的問題——可能是掃描件倒置，或是生成的報告頁面方向不統一，導致閲讀體驗極差，甚至影響打印效果。手動逐頁調整不僅耗時費力，效率也極其低下。別擔心！本文將為您揭示一個高效的解決方案：使用 Python 旋轉 PDF 頁面。我們將重點介紹 Spire.PDF 庫，通過它，您將能夠輕鬆實現 旋轉 PDF 頁面的自動化操作，徹底告別繁瑣的手動調整。
為什麼選擇 Spire.PDF for Python？
Spire.PDF 是一個功能強大且易於使用的PDF處理庫，它允許開發者在Python應用程序中創建、讀取、編輯、轉換和打印PDF文檔。相較於其他一些庫，Spire.PDF Python 旋轉 功能的API設計直觀，性能卓越，尤其適用於企業級應用和需要高效處理大量PDF文件的場景。其主要優勢包括：
- 全面的PDF處理能力: 除了頁面旋轉，還支持文本提取、圖片插入、水印添加、合併、拆分等多種操作。
- 兼容性與穩定性: 能夠穩定處理各種複雜PDF文檔，兼容性良好。
- 易用性: 提供了清晰的API接口和豐富的示例，降低了開發難度。
在開始之前，請確保您已經安裝了 Spire.PDF 庫。如果尚未安裝，可以通過以下命令輕鬆完成：
pip install Spire.PDF基礎操作：旋轉單個PDF頁面
本節將詳細講解如何使用 Spire.PDF 來旋轉PDF文檔中的特定頁面。
導入庫與加載PDF文檔
首先，我們需要導入必要的庫，並加載待處理的PDF文檔。
from spire.pdf.common import *
from spire.pdf import *
# 創建一個PdfDocument對象
doc = PdfDocument()
# 加載現有的PDF文檔
doc.LoadFromFile("input.pdf")請將 "input.pdf" 替換為您實際的PDF文件路徑。
定義旋轉角度與應用旋轉
Spire.PDF 提供了 PdfPageRotateAngle 枚舉類型來定義頁面的旋轉角度，包括 Rotate_0 (不旋轉), Rotate_90 (順時針旋轉90度), Rotate_180 (順時針旋轉180度), Rotate_270 (順時針旋轉270度)。
我們可以通過訪問 doc.Pages[index] 來獲取特定頁面對象，然後設置其 Rotation 屬性。
以下代碼示例將把PDF文檔的第一頁順時針旋轉90度：
# 獲取PDF文檔的第一頁（索引從0開始）
page = doc.Pages[0]
# 設置頁面的旋轉角度為順時針90度
# 可以根據需要選擇 PdfPageRotateAngle.Rotate_90, PdfPageRotateAngle.Rotate_180, PdfPageRotateAngle.Rotate_270
page.Rotation = PdfPageRotateAngle.Rotate_90
# 如果需要基於當前旋轉角度進行增量旋轉，可以這樣做：
# current_rotation = int(page.Rotation.value)
# new_rotation = (current_rotation + int(PdfPageRotateAngle.Rotate_90.value)) % 360
# page.Rotation = PdfPageRotateAngle(new_rotation)保存旋轉後的PDF
完成頁面旋轉操作後，我們需要將修改後的PDF文檔保存為新文件。
# 保存修改後的PDF文檔
doc.SaveToFile("output_rotated_single_page.pdf")
doc.Close()這將把旋轉後的PDF保存為 "output_rotated_single_page.pdf"。
進階操作：批量旋轉PDF頁面
如果需要對PDF文檔中的所有頁面進行統一旋轉，我們可以通過循環遍歷所有頁面來實現。
遍歷所有頁面並旋轉
以下代碼演示瞭如何遍歷PDF文檔的所有頁面，並將它們全部順時針旋轉180度：
from spire.pdf.common import *
from spire.pdf import *
doc = PdfDocument()
doc.LoadFromFile("input.pdf")
# 獲取PDF文檔的頁面數量
page_count = doc.Pages.Count
# 遍歷所有頁面並進行旋轉
for i in range(page_count):
page = doc.Pages[i]
# 將每個頁面順時針旋轉180度
page.Rotation = PdfPageRotateAngle.Rotate_180
# 保存修改後的PDF文檔
doc.SaveToFile("output_rotated_all_pages.pdf")
doc.Close()根據條件選擇性旋轉
在某些場景下，您可能希望根據特定條件（例如，只有橫向頁面才旋轉，或只旋轉奇數頁）進行選擇性旋轉。Spire.PDF 允許您在循環中添加條件判斷邏輯。
例如，只旋轉奇數頁：
# ... (加載PDF文檔的代碼) ...
for i in range(doc.Pages.Count):
if (i + 1) % 2 != 0: # 判斷是否為奇數頁
page = doc.Pages[i]
page.Rotation = PdfPageRotateAngle.Rotate_90
# ... (保存PDF文檔的代碼) ...完整代碼示例
為了方便您快速測試，以下是一個包含加載、旋轉和保存的完整示例，您可以直接複製粘貼並運行：
from spire.pdf.common import *
from spire.pdf import *
import os
# 定義輸入和輸出文件路徑
input_file = "input.pdf"
output_file_single = "output_rotated_single_page.pdf"
output_file_all = "output_rotated_all_pages.pdf"
# 確保輸入文件存在
if not os.path.exists(input_file):
print(f"錯誤：文件 '{input_file}' 不存在。請確保文件路徑正確。")
else:
# --- 示例1：旋轉單個頁面 ---
print(f"正在處理：旋轉 '{input_file}' 的第一頁...")
doc_single = PdfDocument()
doc_single.LoadFromFile(input_file)
# 旋轉第一頁90度
page_single = doc_single.Pages[0]
page_single.Rotation = PdfPageRotateAngle.Rotate_90
doc_single.SaveToFile(output_file_single)
doc_single.Close()
print(f"第一頁已旋轉並保存為 '{output_file_single}'")
# --- 示例2：旋轉所有頁面 ---
print(f"正在處理：旋轉 '{input_file}' 的所有頁面...")
doc_all = PdfDocument()
doc_all.LoadFromFile(input_file)
# 遍歷所有頁面並旋轉180度
for i in range(doc_all.Pages.Count):
page_all = doc_all.Pages[i]
page_all.Rotation = PdfPageRotateAngle.Rotate_180
doc_all.SaveToFile(output_file_all)
doc_all.Close()
print(f"所有頁面已旋轉並保存為 '{output_file_all}'")
print("\n所有操作完成！")總結
通過本文的教程，您已經掌握瞭如何使用 Spire.PDF 庫來高效地 旋轉 PDF 頁面。無論是旋轉單個頁面還是批量旋轉整個文檔，Spire.PDF 都提供了簡潔而強大的API支持。這種自動化的 PDF 處理 Python 方案，極大地提升了文檔處理的效率和準確性。
Python 在自動化文檔處理領域的潛力是巨大的，而 Spire.PDF 只是冰山一角。我們鼓勵您嘗試本文中的代碼示例，並進一步探索 Spire.PDF 的其他強大功能，例如合併、拆分、添加水印等。如果您在實踐中遇到任何問題，或有任何心得體會，歡迎在評論區留言分享！讓我們一起探索Python在文檔處理中的無限可能。
