PDF轉圖片工具技術文檔（命令行版本）

1. 功能概述

本工具是一個基于PyMuPDF庫的PDF轉圖片命令行工具，能夠：

• 通過命令行參數接收PDF文件路徑
• 將PDF的每一頁轉換為PNG格式的圖片
• 自動創建輸出目錄（./static）
• 保存圖片到指定目錄并按頁碼命名

2. 技術棧

• PyMuPDF (fitz): 用于PDF解析和頁面渲染
• Python 3.x: 編程語言環境
• argparse: 處理命令行參數

3. 環境準備

安裝依賴庫

pip install pymupdf

4. 代碼實現

4.1 完整代碼

import fitz# PyMuPDF
import os
import argparsedef pdf_to_images(pdf_path):
"""
將PDF文件轉換為圖片參數:
pdf_path (str): PDF文件路徑
"""
print(f"正在處理文件: {pdf_path}")# 創建輸出目錄
output_dir = './static'
os.makedirs(output_dir, exist_ok=True)try:
# 打開PDF文件
doc = fitz.open(pdf_path)# 遍歷每一頁
for page_num in range(len(doc)):
# 加載頁面
page = doc.load_page(page_num)# 將頁面渲染為像素圖
pix = page.get_pixmap(
alpha=False,# 禁用alpha通道
dpi=300,# 設置DPI
matrix=fitz.Matrix(2.0, 2.0)# 縮放因子
)# 保存為PNG圖片
output_path = f'{output_dir}/page-{page_num+1}.png'
pix.save(output_path)
print(f"已保存: {output_path}")print("轉換完成！")except Exception as e:
print(f"發生錯誤: {str(e)}")
finally:
if 'doc' in locals():
doc.close()if __name__ == "__main__":
# 設置命令行參數解析
parser = argparse.ArgumentParser(description='PDF轉圖片工具')
parser.add_argument('pdf_file', help='要轉換的PDF文件路徑')args = parser.parse_args()# 檢查文件是否存在
if not os.path.exists(args.pdf_file):
print(f"錯誤: 文件 {args.pdf_file} 不存在")
exit(1)# 執行轉換
pdf_to_images(args.pdf_file)

4.2 代碼說明

1. 參數處理：

• 使用argparse模塊處理命令行參數
• 必需參數pdf_file指定要轉換的PDF文件路徑

2. 文件檢查：

• 驗證輸入的PDF文件是否存在

3. 輸出目錄：

• 自動創建./static目錄（如果不存在）

4. 轉換過程：

• 設置300 DPI和2倍縮放確保高質量輸出
• 每頁保存為page-{頁碼}.png格式

5. 錯誤處理：

• 捕獲并顯示轉換過程中的異常

5. 使用說明

5.1 基本用法

python pdf_to_image.py 輸入文件.pdf

5.2 示例

# 轉換當前目錄下的sample.pdf
python pdf_to_image.py sample.pdf# 轉換指定路徑的PDF文件
python pdf_to_image.py /path/to/document.pdf

5.3 輸出結果

轉換后的圖片將保存在./static目錄下：

./static/
page-1.png
page-2.png
...

6. 高級配置

6.1 自定義輸出目錄

修改代碼中的output_dir變量：

output_dir = './custom_output'# 修改為想要的目錄

6.2 調整輸出質量

修改get_pixmap參數：

pix = page.get_pixmap(
alpha=False,
dpi=600,# 更高DPI
matrix=fitz.Matrix(3.0, 3.0)# 更大縮放因子
)

6.3 支持其他圖片格式

修改保存格式（如JPEG）：

output_path = f'{output_dir}/page-{page_num+1}.jpg'
pix.save(output_path, "jpeg", quality=95)# JPEG質量參數

7. 常見問題

7.1 文件權限問題

錯誤：

PermissionError: [Errno 13] Permission denied

解決方案：

• 確保有目標目錄的寫入權限
• 或指定其他可寫目錄作為輸出目錄

7.2 中文路徑問題

解決方案：

# 處理中文路徑
pdf_path = pdf_path.encode('utf-8').decode('gbk')

7.3 大文件處理

優化建議：

• 分批處理大型PDF文件
• 增加內存檢查機制

8. 擴展功能建議

1. 批量處理：

• 支持目錄下所有PDF文件的批量轉換

2. 進度顯示：

• 添加進度條顯示轉換進度

3. 多線程處理：

• 對大文件使用多線程加速轉換

4. 輸出配置：

• 通過命令行參數指定輸出目錄和圖片質量

9. 替代方案

如果不需要命令行交互，可以直接拖放文件到腳本：

import sysif __name__ == "__main__":
if len(sys.argv) < 2:
print("請將PDF文件拖放到此腳本上")
input("按回車鍵退出...")
exit(1)pdf_to_images(sys.argv[1])

10. 結論

這個命令行版本的PDF轉圖片工具去除了GUI依賴，更適合自動化處理場景。通過簡單的命令行參數即可完成轉換，輸出質量高且穩定，適合集成到自動化工作流中。