Python img2pdf 库实现图像批量转换为 PDF 教程

运行上述代码后，当前目录下会生成 animals.pdf，其中包含两张按顺序排列的图片。

进阶用法：自定义页面属性

1. 设置页面尺寸

默认情况下，PDF 页面尺寸会根据第一张图像的尺寸决定。如果需要统一为 A4 或 Letter 纸张，可以使用 pagesize 参数。

import img2pdf
from PIL import Image

images = ["photo1.jpg", "photo2.jpg"]
output = "a4_photos.pdf"

# 指定页面大小为 A4 (595 x 842 points)
pdf_bytes = img2pdf.convert(
    images,
    layout_fun=img2pdf.get_fixed_dpi_layout(595, 842),
    rotation=img2pdf.Rotation.auto
)

with open(output, "wb") as f:
    f.write(pdf_bytes)

2. 调整图像方向

如果图像方向与页面不符，可以强制旋转。img2pdf 提供了 Rotation 枚举类。

import img2pdf

images = ["portrait_photo.jpg"]
output = "landscape_pdf.pdf"

# 强制旋转为横向
pdf_bytes = img2pdf.convert(
    images,
    rotation=img2pdf.Rotation.rotate_90
)

with open(output, "wb") as f:
    f.write(pdf_bytes)

支持的旋转选项包括：

• img2pdf.Rotation.auto: 自动判断
• img2pdf.Rotation.rotate_90: 顺时针旋转 90 度
• img2pdf.Rotation.rotate_180: 旋转 180 度
• img2pdf.Rotation.rotate_270: 逆时针旋转 90 度
• img2pdf.Rotation.no_rotation: 不旋转

3. 设置 PDF 元数据

可以为生成的 PDF 添加标题、作者等信息，这有助于在文件管理器中查看摘要。

import img2pdf

images = ["report.png"]
output = "report_metadata.pdf"

metadata = {
    b'Title': b'季度报告',
    b'Author': b'技术部',
    b'Subject': b'数据分析'
}

pdf_bytes = img2pdf.convert(
    images,
    metadata=metadata
)

with open(output, "wb") as f:
    f.write(pdf_bytes)

错误处理与常见问题

1. 文件未找到

确保传入的图像路径正确且文件存在。建议使用绝对路径或在脚本执行前确认当前工作目录。

import os

if not all(os.path.exists(img) for img in images):
    raise FileNotFoundError("部分图像文件不存在")

2. 权限问题

确保输出目录有写入权限。如果遇到 PermissionError，请检查文件夹权限或尝试以管理员身份运行脚本。

3. 内存溢出

对于超高分辨率的大图或大量图片，一次性转换可能消耗大量内存。建议分批处理或使用流式写入（如果适用）。

性能优化建议

1. 批量处理：利用 os.listdir 遍历文件夹，自动收集所有图片路径。
2. 压缩控制：img2pdf 默认保留原始图像编码。如需减小体积，可先使用 Pillow 压缩图像再转换。
3. 并行处理：对于极大批量任务，可使用 concurrent.futures 模块并行处理多个小批次。

与其他方案对比

总结

本文详细介绍了如何使用 Python 的 img2pdf 库将多张图像高效转换为 PDF 文件。通过掌握基础转换、页面尺寸调整、方向旋转及元数据设置，用户可以轻松实现文档的自动化处理流程。该方案无需安装额外的专业软件，非常适合开发集成工具或日常办公自动化需求。

若遇到更复杂的排版需求，建议结合 Pillow 进行预处理后再使用 img2pdf 生成最终 PDF。