reportlab 是 Python 生成 PDF 的經典庫,支援向量繪圖、文字排版、圖片嵌入等功能。本文展示如何將單張或多張圖片轉換為 PDF 文檔,涵蓋頁面大小適配、橫向/縱向自動判斷、批量處理與常見問題解決。
pip install reportlab Pillow
#!/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')
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。掌握多種方案,應對不同業務場景游刃有餘。