根本原因是Pillow在RGB底图上直接用RGBA模式绘文字时未显式转换模式，导致alpha丢失或误解释而发虚变色；且跨系统字体hinting差异引发位置偏移。
为什么 Pillow 直接叠加文字水印会发虚、变色或位置偏移
根本原因是 Pillow 默认用 RGBA 模式绘制文字时，若底图是 RGB（比如 JPEG），没显式转模式就 paste，alpha 通道会被丢弃或错误解释，导致半透明区域糊成一片、颜色泛灰，甚至文字边缘出现青/紫边。另外，ImageFont.truetype 在不同系统上默认渲染 hinting 行为不一致，同一字号在 macOS/Linux/Windows 上实际像素高度可能差 1–2px，批量处理时位置就“飘”了。
实操建议：
立即学习“Python免费学习笔记（深入）”；
- 底图统一转为
RGBA：用img.convert("RGBA")，别依赖自动转换 - 文字图层单独建
RGBA画布，用ImageDraw.Draw(text_layer)绘制，再用Image.alpha_composite合成（不是paste） - 字体路径必须绝对路径或明确存在判断，
ImageFont.truetype("simhei.ttf", size)在服务器常因缺字体报OSError: cannot open resource - 字号建议用整数，避免传入
size=12.5这类浮点——Pillow会截断但不报错，实际变小
多线程跑 Pillow 批量加水印反而更慢？内存爆掉怎么办
Pillow 图像对象不是线程安全的，且每个 Image 实例背后是独立的 C 内存块；多线程里反复 open → convert → save，会触发大量内存分配/释放，Python 的 GIL 虽然限制了 CPU 密集型并行，但 I/O 和内存抖动反而更严重。常见现象是：开 8 线程，CPU 占用不到 30%，RSS 内存涨到 4GB+，然后被系统 OOM kill。
实操建议：
立即学习“Python免费学习笔记（深入）”；
- 改用
concurrent.futures.ProcessPoolExecutor，进程隔离内存，避免 Pillow 对象跨进程共享问题 - 每个子进程内控制单次处理数量，比如每批 50 张图后主动
del img, watermark, text_layer+gc.collect() - 禁止在主线程预加载所有图片到内存（
images = [Image.open(p) for p in paths]），改用子进程中按需打开 - 输出格式优先选
WEBP或压缩后的JPEG：img.save(out_path, quality=85, optimize=True)，别用默认 quality=75 以下，否则文件体积翻倍
Image.alpha_composite 和 Image.paste 选哪个？透明 Logo 总是黑底
Logo 是 PNG 带 alpha 通道，但直接 base.paste(logo, pos, logo) 后出现黑底，说明 logo 的 alpha 没被正确识别——常见于读取时没指定模式，Image.open("logo.png") 返回的是 RGB 模式（丢弃了 alpha），或者 logo 本身是 LA（灰度+alpha）模式但没转对。
实操建议：
立即学习“Python免费学习笔记（深入）”；
- 强制转
RGBA：logo = Image.open("logo.png").convert("RGBA")，哪怕它本来就是 PNG - 合成必须用
Image.alpha_composite：先确保base和overlay都是RGBA且尺寸一致，再result = Image.alpha_composite(base, overlay) - 如果 logo 尺寸小，用
logo.resize((w, h), Image.LANCZOS)，别用NEAREST，锯齿太明显；大图缩放慎用BICUBIC，耗时高 - 位置计算别写死像素值，用
(base.width - logo.width, base.height - logo.height)做右下角锚点，比(100, 100)更可靠
并发写文件报 PermissionError: [Errno 13] Permission denied 或覆盖失败
多个进程同时往同一个目录写文件，尤其 Windows 下，NTFS 对文件句柄敏感，save() 调用底层 fopen 时可能撞上其他进程正在写同名临时文件，或目标路径父目录权限不足（比如 Docker 容器挂载的只读 volume）。另一个隐形坑是：用 os.path.join(out_dir, filename) 拼路径，但 filename 里混入了 ../ 或空格、中文，导致路径穿越或编码异常。
实操建议：
立即学习“Python免费学习笔记（深入）”；
- 输出路径提前用
os.makedirs(out_dir, exist_ok=True)创建，别指望save()自动建目录 - 文件名做基础清洗：
re.sub(r"[^a-zA-Z0-9._-]", "_", original_name)，去掉斜杠、控制符、emoji - Windows 下避免使用
\?扩展路径，Pillow不认；Linux/macOS 注意挂载卷是否启用noexec或nosuid - 加水印前先
try: img.verify() except Exception: continue，跳过损坏图，防止某张坏图卡住整个进程
事情说清了就结束。最麻烦的其实是字体路径和图像模式转换——这两处不出错，后面并发、合成、保存基本不会崩。但它们又最容易被当成“小问题”跳过去。
