PNG变黑或JPG丢透明因RGBA未适配：JPG不支持Alpha，需先合成背景（如白底）；WEBP更优；大图用draft降采样；中文路径用Path.resolve()转绝对路径。
用 Image.save() 导出不同格式时，为什么 PNG 变成黑图或 JPG 丢透明通道？
因为 Image.save() 不会自动处理颜色模式适配。源图是 "RGBA"（带 Alpha），直接存为 JPG（不支持透明）会强制转成 "RGB"，但默认丢弃 Alpha 通道且不填底色，结果就是透明区域变黑。
- 导出前先检查
img.mode：如果是"RGBA"或"LA"，要手动合成背景（比如白底）再保存 - JPG 不支持透明，强制保存会静默丢 Alpha；PNG、WEBP、TIFF 才支持
- 合成示例：
bg = Image.new("RGB", img.size, (255, 255, 255)); bg.paste(img, mask=img.split()[-1] if img.mode == "RGBA" else None) - WEBP 格式对透明支持好，且压缩率高，适合替代 PNG，但旧版 Pillow（lossless=True 或
method=6
批量转换时，os.listdir() 和 pathlib.Path().glob() 哪个更稳？
pathlib 更推荐——它天然区分文件/目录、自动处理路径分隔符、支持后缀过滤，避免手写字符串匹配出错。
-
os.listdir()返回纯文件名列表，不含路径，容易漏掉子目录或误读隐藏文件（如 macOS 的.DS_Store） - 用
Path("input_dir").glob("*.jpg")可精准按扩展名过滤，加**/*.png还能递归 - 务必用
.is_file()判定，防止把同名目录当文件打开报IsADirectoryError - Windows 下大小写不敏感，但 Linux/macOS 敏感，用
.suffix.lower() in {".jpg", ".jpeg", ".png"}更安全
内存爆了？大图批量处理必须避开 Image.open().convert() 无脑链式调用
每次 .convert() 都生成新图像对象，原图还在内存里，尤其处理几百张 4K 图时，没及时 del img 或用上下文管理，Python GC 来不及回收。
- 优先用
with Image.open(path) as img:，确保文件句柄和像素数据及时释放 - 避免写成
img.convert("RGB").save(...)—— 中间对象没引用，但 Pillow 内部缓存可能滞留；拆成两步 + 显式del更可控 - 超大图（>5000px）考虑用
img.draft("RGB", (1920, 1080))先降采样再操作，节省内存 - 真要压内存，就别一次全 load：用
glob+ 循环单张处理，别用list comprehension提前 collect 所有Image对象
中文路径报 OSError: cannot open resource 怎么办？
不是编码问题，是 Pillow 底层的 libjpeg/libpng 在 Windows 上对宽字符路径支持差，open 函数本身在 Python 3.6+ 已修复，但 Pillow 的某些加载器仍会 fallback 到 C 层路径处理。
- 最简方案：用
pathlib.Path.resolve()转成绝对路径，再转str传给Image.open() - 别用
os.path.join()拼路径，改用Path(dir) / filename，它自动处理分隔符和编码边界 - 如果仍失败，临时把文件 copy 到纯英文路径下处理（比如
./tmp_work/），完事再移回，比折腾编码参数快 - Mac/Linux 一般不触发此问题，但 Docker 容器内若 locale 未设为
en_US.UTF-8，也可能复现
事情说清了就结束。真正卡住的往往不是格式转换逻辑，而是模式转换时的隐式丢通道、路径里的 Unicode 边界、还有大图堆内存时不声不响的泄漏。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
