在日常办公或文档处理中,我们经常需要将多张图片合并成一个 PDF 文件。无论是扫描件整理、电子书制作,还是资料归档,将图片转换为 PDF 都是一项非常实用的需求。本文将介绍如何使用 Python 和 Spire.PDF for Python 库,轻松实现图片到 PDF 的转换与合并功能。
为什么选择 Spire.PDF for Python?
Spire.PDF for Python 是一个功能强大的 PDF 操作库,它不仅支持创建、读取和编辑 PDF 文档,还提供了丰富的图像处理功能。相比于其他库,Spire.PDF 的 API 设计简洁直观,能够轻松完成图片到 PDF 的转换,并允许我们精确控制页面尺寸和图片布局。
完整代码实现
以下代码展示了如何将指定文件夹中的所有 JPG/JPEG 图片合并为一个 PDF 文件:
ini
from spire.pdf import *
import os
# 包含图片的文件夹路径
image_folder = r"C:\Users\Administrator\Desktop\Images"
# 输出 PDF 文件路径
output_file = "output/CombinedImages.pdf"
# 确保输出目录存在
os.makedirs(os.path.dirname(output_file), exist_ok=True)
# 创建 PDF 文档对象
doc = PdfDocument()
# 移除页面边距,让图片铺满整页
doc.PageSettings.SetMargins(0.0)
# 获取所有 JPG/JPEG 文件并排序
image_files = sorted([
f for f in os.listdir(image_folder)
if f.lower().endswith((".jpg", ".jpeg"))
])
# 将每张图片添加到 PDF 中
for image_name in image_files:
image_path = os.path.join(image_folder, image_name)
# 加载图片
image = PdfImage.FromFile(image_path)
# 获取图片尺寸
width = image.PhysicalDimension.Width
height = image.PhysicalDimension.Height
# 创建与图片尺寸相同的页面
page = doc.Pages.Add(SizeF(width, height))
# 在页面上绘制图片
page.Canvas.DrawImage(image, 0.0, 0.0, width, height)
# 保存合并后的 PDF 文件
doc.SaveToFile(output_file)
doc.Dispose()
代码解析
- 导入库和设置路径 :首先导入 Spire.PDF 和 os 模块,定义图片文件夹路径和输出文件路径。
- 创建 PDF 文档 :通过
PdfDocument()创建空白 PDF 文档,并使用SetMargins(0)移除页面边距,确保图片能够完整铺满页面。 - 读取图片文件 :使用
os.listdir()获取文件夹中所有图片文件,通过endswith()筛选 JPG 和 JPEG 格式,并用sorted()进行排序,保证图片按文件名顺序合并。 - 逐张添加图片 :对于每张图片,使用
PdfImage.FromFile()加载,获取其原始尺寸,然后创建相同尺寸的 PDF 页面,最后通过DrawImage()将图片绘制到页面中。 - 保存和释放资源 :使用
SaveToFile()保存 PDF 文件,并调用Dispose()释放文档资源。
运行效果
执行上述代码后,程序会自动在 output 文件夹下生成 CombinedImages.pdf 文件。该 PDF 中的每一页对应一张原始图片,页面大小与图片尺寸完全一致,保证了图片的最佳显示效果。

扩展应用
基于上述代码,我们可以轻松扩展更多功能:
- 支持更多图片格式 :在筛选条件中添加
.png、.bmp等格式 - 自定义页面大小 :可以统一设置固定页面尺寸,而非跟随图片尺寸
- 添加图片压缩 :通过调整图片质量来控制 PDF 文件大小
- 批量处理 :对多个文件夹分别生成对应的 PDF 文件
总结
使用 Spire.PDF for Python 实现图片转 PDF 功能,代码简洁、易于理解,且无需安装额外依赖。无论是个人用户还是企业级应用,都可以快速集成这一功能。希望本文能帮助你在文档处理工作中提升效率,让图片管理和分享变得更加便捷。