`pdf2image` 是一个将 PDF 文件转换为图像的强大工具包。其中 `convert_from_path` 函数是最常用的功能之一，用于从指定路径读取 PDF 并将其每一页转换为 PIL 图像对象。 ### 使用说明 下面是关于如何使用 `convert_from_path` 的详细介绍： #### 参数详解 ```python from pdf2image import convert_from_path images = convert_from_path( pdf_path, # PDF 文件的绝对路径或相对路径 (必填) dpi=200, # 输出图片的分辨率，默认值为 200 DPI first_page=None, # 要开始转换的页面编号（默认为 None 表示第一页） last_page=None, # 要停止转换的页面编号（默认为 None 表示最后一页） fmt="ppm", # 输出格式，默认为 ppm 格式 thread_count=1, # 线程数，默认为单线程处理 userpw=None, # 如果PDF有密码保护，则在此处提供密码 use_cropbox=False, # 是否裁剪到 CropBox 区域内（布尔值） strict=False, # 报错时是否抛出异常（False 则忽略错误） transparent=False, # 是否创建透明背景的 PNG 或 TIFF （仅支持这俩种格式） poppler_path=None # Poppler 可执行程序的自定义路径（Windows 用户需设置该参数） ) ``` #### 示例代码 下面是一个简单的例子，演示如何将 PDF 文件的第一页转成 PNG 图片，并保存到本地： ```python from pdf2image import convert_from_path # 将 PDF 第一页转成图片 images = convert_from_path('example.pdf', dpi=300, first_page=1, last_page=1) # 存储生成的图片 for i, image in enumerate(images): image.save(f"output_{i+1}.png", "PNG") ``` --- ### 注意事项 1. 需要安装 Poppler 工具集才能正常使用本模块，在 Windows 上还需要配置其路径。 ```bash pip install pdf2image ``` 2. 对于 Windows 操作系统用户来说，下载 [Poppler for Windows](https://github.com/oschwartz10612/poppler-windows/releases/) 后解压至某目录并将路径赋值给 `poppler_path` 参数即可正常工作。 ---