### 安装和使用 `img2pdf` 库 #### 安装过程 为了在 Python 中安装并使用 `img2pdf` 库，可以通过以下命令完成安装。该库依赖于 Pillow（PIL 的现代分支），而后者通常会在安装过程中自动处理。 ```bash pip install img2pdf ``` 如果遇到任何问题，请确保已更新 pip 工具至最新版本： ```bash pip install --upgrade pip ``` #### 基本使用方法 以下是通过几行代码实现将图片转换为 PDF 文件的一个简单示例[^1]： ```python import img2pdf from PIL import Image import os # 图片路径 image_path = "example.jpg" # PDF 输出路径 output_pdf_path = "output.pdf" # 打开图像文件 with Image.open(image_path) as image: # 转换颜色模式为 RGB image = image.convert("RGB") # 使用 img2pdf 进行转换 pdf_bytes = img2pdf.convert(image.filename) # 写入到 PDF 文件 with open(output_pdf_path, "wb") as file: file.write(pdf_bytes) ``` 对于 PNG 格式的图片，在某些情况下可能需要先将其转换为 JPG 格式再进行操作[^2]。这一步骤可通过如下代码片段来完成： ```python from PIL import Image input_png = "myPNG.png" output_jpg = "myJPG.jpg" im = Image.open(input_png).convert('RGB') im.save(output_jpg, quality=95) ``` #### 错误处理 当尝试将带有 EXIF 数据的图片转换成 PDF 时，可能会触发错误 `img2pdf.ExifOrientationError`。此问题是由于旋转元数据不一致引起的。解决方案之一是在调用 `img2pdf.convert()` 方法时指定参数 `rotation=img2pdf.Rotation.ifvalid` 来忽略这些潜在冲突[^4]。 修正后的代码如下所示： ```python import img2pdf from PIL import Image import os image_path = "example_with_exif.jpg" output_pdf_path = "output_with_rotation_handling.pdf" # 处理图片方向问题 layout_fun = img2pdf.get_layout_fun(img2pdf.ImageRegion.boxfit) with Image.open(image_path) as image: image = image.convert("RGB") pdf_bytes = img2pdf.convert( image.filename, rotation=img2pdf.Rotation.ifvalid, layoutfun=layout_fun ) with open(output_pdf_path, "wb") as file: file.write(pdf_bytes) ``` 上述代码不仅解决了旋转问题，还引入了一个布局函数用于优化页面适应性。 ---