最稳方案是用pil.image.paste配合alpha mask：水印转rgba后提取alpha通道，用brightness调节透明度，原图转rgba再paste，最后转回rgb保存；全程避免opencv处理alpha，预加载复用水印资源。
用PIL.Image.paste加mask实现半透明水印最稳
直接上结论：别用 Image.alpha_composite，它要求两张图尺寸严格一致且都带Alpha通道，批量处理时极易因尺寸不匹配报 ValueError: images do not match。真正可靠的是用 Image.paste 配合带Alpha的mask——把水印图转成RGBA，再用它的Alpha通道当mask贴到原图指定位置。
关键点在于：水印图本身可以是PNG（带透明背景），但必须先统一转为RGBA模式，再提取其Alpha通道生成mask；原图如果是RGB，要先转成RGBA才能接受透明叠加，最后再转回RGB保存（避免体积暴增）。
- 水印图建议预处理为纯白文字+0–255灰度Alpha通道（不是“半透PNG”，而是“白底+独立Alpha”），方便后续统一调节透明度
- 透明度控制不要改水印图本身的Alpha值，而是在生成mask时做缩放：
mask = ImageEnhance.Brightness(alpha).enhance(0.3)，这样可动态调整，不用重做素材 - 贴图位置推荐用百分比锚点（如右下角10%留白），避免硬编码像素值导致不同分辨率图片水印错位
OpenCV + PIL混用时alpha通道容易丢
有人想用OpenCV读图提速（cv2.imread(path, cv2.IMREAD_UNCHANGED)），但OpenCV默认BGR顺序、且对Alpha通道解析不稳定——尤其遇到带premultiplied alpha的PNG时，cv2.imread 会直接丢掉Alpha或输出错误值，导致paste后水印全黑或全白。
实操建议全程用PIL：Image.open() 能正确识别PNG的Alpha通道，.convert("RGBA") 强制统一模式，再用 .split() 安全提取Alpha。如果真要加速，用 Image.open().load() 触发解码，或开多进程（别用OpenCV插手Alpha部分）。
- 绝对不要用
cv2.cvtColor(img_cv, cv2.COLOR_BGRA2RGBA)后转PIL——OpenCV的BGRA和PIL的RGBA内存布局不同，易错位 - 检查水印是否生效？临时把mask保存出来：
mask.save("debug_mask.png")，看是不是你想要的灰度渐变 - 批量处理前，先用一张图跑通完整流程：读原图→读水印→转RGBA→提取alpha→调亮度→paste→转RGB→保存
批量处理卡在内存溢出或速度慢
问题不在代码逻辑，而在图像加载方式。PIL默认延迟加载，但当你对同一张图反复调用 .convert()、.resize()、.paste() 时，内部会多次解码，小图不明显，但处理2000张4K图时内存可能飙到8GB+。
解决方案是「一次解码，多次复用」：把水印图提前加载、转好RGBA、生成好mask并缓存；原图用 Image.open().copy() 确保操作不污染原始对象；贴图后立刻调用 img.close()（虽然PIL有GC，但显式关闭更稳妥）。
- 水印图复用示例：
WATERMARK_IMG = Image.open("logo.png").convert("RGBA"); ALPHA_MASK = WATERMARK_IMG.split()[-1]，放在循环外 - 避免在循环里写
Image.open(watermark_path).convert("RGBA")——每张图都重新打开解码，IO+CPU双浪费 - 单进程处理万级图片时，用
concurrent.futures.ProcessPoolExecutor比ThreadPoolExecutor更有效，PIL的CPU密集型操作GIL锁得死
中文水印用PIL.Draw.text透明度难控
如果水印是动态生成的文字（比如文件名+时间戳），别用 ImageDraw.text() 直接画到RGBA图上——它的fill参数只支持纯色，无法设透明度；填 (255,255,255,100) 看似可行，但实际渲染时会因字体抗锯齿与混合模式导致边缘发虚或不透明。
正解是分两步：先在空白RGBA图上用 text() 画纯白文字（fill=(255,255,255,255)），再单独提取这张图的Alpha通道，用 Brightness 降低整体alpha值，最后作为mask贴到原图。这样文字边缘锐利，透明度均匀。
- 字体必须用支持中文的ttf文件路径，不能只写"simhei.ttf"——系统路径不一致，打包后大概率报
OSError: cannot open resource - 字号别用固定像素，按原图短边比例算：
font_size = int(min(img.size) * 0.03)，否则手机图上水印大过主体 - 文字位置计算时，用
draw.textbbox((0,0), text, font=font)替代旧版draw.textsize()（已弃用）
水印的透明度本质是Alpha通道的数值缩放，不是颜色混合；批量场景下，预处理水印资源比现场生成更可控。最容易被忽略的是：同一份水印图，在不同尺寸原图上应等比缩放，而不是固定大小——否则小图上水印糊成一团，大图上细若游丝。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
