img2pdf可无损合成PDF，不依赖Ghostscript或PIL，但路径不能含中文或空格，顺序由输入列表决定；需Python 3.7+，安装后验证版本≥0.4.0，写入时须用二进制模式。
直接用 img2pdf 就能无损合成，不依赖 Ghostscript 或 PIL，连 Alpha 通道和 CMYK 图都不用预处理——但前提是图片路径不能含中文或空格，且顺序得靠文件名控制。
安装 img2pdf 并确认 Python 环境兼容性
img2pdf 是纯 Python 模块，不调用外部二进制，所以 Windows/macOS/Linux 全平台一致。但它只支持 Python 3.7+，且不兼容 PyPy。
- 运行
pip install img2pdf即可，无需额外依赖 - 若报错
ModuleNotFoundError: No module named 'PIL'，说明你误装了旧版（img2pdf<0.4），必须卸载重装：pip uninstall img2pdf && pip install img2pdf - 检查版本：
python -c "import img2pdf; print(img2pdf.__version__)"，确保 ≥ 0.4.0
按指定顺序合成多张图片：路径、排序与字节流处理
模块本身不读取文件名排序，img2pdf.convert() 接收的是字节列表或文件路径列表，顺序完全由你传入的列表决定。
- 避免用
glob.glob("*.jpg")直接获取——系统返回顺序不可靠，改用sorted(glob.glob("*.png")) - 路径必须是绝对路径或当前工作目录下的相对路径；含中文、空格、括号的路径会触发
OSError: Invalid argument - 若图片来自内存（如
io.BytesIO），需先用.getvalue()提取 bytes，再传给img2pdf.convert() - 示例关键代码：
import img2pdf import glob确保顺序：按数字前缀排序，如 01_cover.jpg, 02_content.jpg
paths = sorted(glob.glob("*.jpg"), key=lambda x: int(x.split("")[0]) if x.split("")[0].isdigit() else 0) pdf_bytes = img2pdf.convert(paths)
控制 PDF 页面尺寸与 DPI：不拉伸、不裁剪的关键参数
默认行为是把图片原尺寸映射为 PDF 页面（单位：点，1点=1/72英寸），不缩放不插值。但若图片 DPI 信息缺失，PDF 查看器可能显示过小——这时要手动指定 dpi 或 layout_fun。
Python 3.14.3
微软官方的 Python 扩展，是 VS Code 安装量最高的扩展（209M+）。集成 IntelliSense（通过 Pylance）、调试（通过 Python Debugger）、代码检查、格式化、重构和单元测试等功能。支持 Jupyter Notebook、虚拟环境管理和多 Python 版本切换。
-
dpi=72（默认）对应 1px = 1pt，即图片宽高直接转为 PDF 宽高（单位 pt） - 想让 300 DPI 扫描图在 PDF 中物理尺寸正确，传
dpi=300，模块会自动换算页面大小 - 强制统一 A4 尺寸（595×842 pt）且保持原始宽高比，用
layout_fun=img2pdf.get_layout_fun((595, 842)) - 禁止任何自动缩放：不要用
img2pdf.pipe或img2pdf.pdfdoc这类底层函数，它们不校验输入
写入文件时的编码与权限陷阱
img2pdf.convert() 返回的是 bytes，必须以二进制模式写入，且目标路径父目录必须已存在。
- 错误写法：
open("out.pdf", "w").write(pdf_bytes)→TypeError: write() argument must be str - 正确写法：
with open("out.pdf", "wb") as f: f.write(pdf_bytes) - 若输出路径是
./output/2024_report.pdf，需提前创建output/目录，否则抛FileNotFoundError - Windows 下路径反斜杠不用转义，但建议统一用正斜杠或
os.path.join
最常被跳过的细节是图片元数据：某些相机直出的 JPEG 带旋转 EXIF 标签，img2pdf 完全忽略它，结果 PDF 里图片倒着——得在合成前用 PIL.ImageOps.exif_transpose() 预处理。
