萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> 程式語言綜合

Python ReportLab 將圖片批量轉換為 PDF 完整指南

reportlab 是 Python 生成 PDF 的經典庫,支援向量繪圖、文字排版、圖片嵌入等功能。本文展示如何將單張或多張圖片轉換為 PDF 文檔,涵蓋頁面大小適配、橫向/縱向自動判斷、批量處理與常見問題解決。

安裝依賴


pip install reportlab Pillow

單張圖片轉 PDF (基礎版)


#!/usr/bin/env python
# -*- coding: utf-8 -*-
import sys
import os
from reportlab.lib.pagesizes import A4, landscape
from reportlab.pdfgen import canvas

def image_to_pdf(image_path, output_path=None):
    if output_path is None:
        base = os.path.splitext(image_path)[0]
        output_path = base + '.pdf'
    
    # 讀取圖片尺寸 (需 Pillow)
    from PIL import Image
    with Image.open(image_path) as img:
        img_w, img_h = img.size
    
    # 選擇頁面大小:A4 橫向/縱向自適應
    page_w, page_h = landscape(A4) if img_w > img_h else A4
    
    c = canvas.Canvas(output_path, pagesize=(page_w, page_h))
    # 圖片置中繪製,保持比例縮放至頁面邊距內
    margin = 20
    max_w, max_h = page_w - 2*margin, page_h - 2*margin
    scale = min(max_w/img_w, max_h/img_h, 1.0)  # 不放大
    draw_w, draw_h = img_w * scale, img_h * scale
    x = (page_w - draw_w) / 2
    y = (page_h - draw_h) / 2
    
    c.drawImage(image_path, x, y, width=draw_w, height=draw_h)
    c.save()
    print(f"已生成: {output_path}")

if __name__ == '__main__':
    if len(sys.argv) < 2:
        print("用法: python img2pdf.py image.jpg [output.pdf]")
        sys.exit(1)
    image_to_pdf(sys.argv[1], sys.argv[2] if len(sys.argv) > 2 else None)

批量轉換目錄下所有圖片


import glob
from pathlib import Path

def batch_convert(input_dir, output_dir=None, pattern='*.jpg'):
    input_path = Path(input_dir)
    if output_dir:
        output_path = Path(output_dir)
        output_path.mkdir(parents=True, exist_ok=True)
    else:
        output_path = input_path
    
    for img_file in input_path.glob(pattern):
        out_file = output_path / (img_file.stem + '.pdf')
        try:
            image_to_pdf(str(img_file), str(out_file))
        except Exception as e:
            print(f"失敗 {img_file}: {e}")

# 使用
batch_convert('./photos', './pdfs', '*.jpg')
batch_convert('./photos', './pdfs', '*.png')

多圖合併為單一 PDF (每頁一圖)


def images_to_single_pdf(image_paths, output_path, pagesize=A4):
    c = canvas.Canvas(output_path, pagesize=pagesize)
    page_w, page_h = pagesize
    
    for img_path in image_paths:
        from PIL import Image
        with Image.open(img_path) as img:
            img_w, img_h = img.size
        
        # 自動旋轉頁面適配圖片方向
        if img_w > img_h:
            c.setPageSize(landscape(pagesize))
            page_w, page_h = landscape(pagesize)
        else:
            c.setPageSize(pagesize)
            page_w, page_h = pagesize
        
        margin = 20
        max_w, max_h = page_w - 2*margin, page_h - 2*margin
        scale = min(max_w/img_w, max_h/img_h, 1.0)
        draw_w, draw_h = img_w * scale, img_h * scale
        x = (page_w - draw_w) / 2
        y = (page_h - draw_h) / 2
        
        c.drawImage(img_path, x, y, width=draw_w, height=draw_h)
        c.showPage()  # 換頁
    
    c.save()
    print(f"合併 PDF 已生成: {output_path}")

# 使用
images_to_single_pdf(sorted(Path('./photos').glob('*.jpg')), 'album.pdf')

進階功能

  • 添加水印/頁碼: 在 showPage() 前繪製文字/圖形
  • 壓縮優化: c.setCompression(1) 啟用內容流壓縮
  • 元數據: c.setTitle(), c.setAuthor(), c.setSubject()
  • 加密保護: c.encrypt(user_pwd, owner_pwd, can_print=1)

常見問題與解決

問題原因解決
圖片顯示空白/錯誤路徑包含中文/特殊字符使用 os.path.abspath 或 Path.resolve()
大圖超出頁面未縮放繪製計算縮放比例 min(page_w/img_w, page_h/img_h)
方向錯誤未根據圖片長寬比選擇橫向/縱向動態 setPageSize(landscape(A4))
記憶體不足超大圖片一次性載入分批處理、使用 drawImage 惰性讀取

替代方案對比

工具優點缺點適用場景
ReportLab功能豐富、可程式化控制純 Python 較慢、學習曲線陡需添加文字、水印、表格、加密
img2pdf無損轉換、極快、保持原始 DPI不支援編輯、僅轉換純圖片轉 PDF、批量處理
Pillow + fpdf2輕量、API 簡單功能較少簡單單頁轉換
LibreOffice 轉換支援所有格式需安裝 LO、啟動慢文檔格式轉換

# img2pdf 極簡用法 (推薦純圖片轉換)
import img2pdf
with open("output.pdf", "wb") as f:
    f.write(img2pdf.convert("image.jpg"))

根據需求選擇工具:需程式化控制選 ReportLab,追求無損高效選 img2pdf,簡單腳本選 fpdf2。掌握多種方案,應對不同業務場景游刃有餘。

copyright © 萬盛學電腦網 all rights reserved