最稳方案是先复制原图再用ImageDraw.Draw()叠加文字水印；位置和字体大小需按图片尺寸动态计算，如( int(w0.02), int(h0.95) )和int(w*0.03)；中文必须指定字体路径并传size参数；颜色用RGBA元组控制透明度；批量处理推荐pathlib.Path.glob()配合try/except错误隔离；PNG logo贴图需用paste(mask)保留透明；保存时设quality=95、subsampling=0提速；输入输出目录分离减少I/O抖动。
用PIL.ImageDraw在循环里叠加文字水印最稳
直接改原图容易误操作，必须先复制再处理。Image.open()读取后用.copy()生成新对象，再用ImageDraw.Draw()往上面画——别试图用Image.alpha_composite()或paste()叠文字，透明度控制麻烦还容易错位。
常见错误是水印位置写死成(10, 10)，结果小图上压到主体、大图上缩成针尖。推荐用图片尺寸动态算：(int(w * 0.02), int(h * 0.95))（左下角偏移2%宽、5%高），字体大小也按宽度比例设：int(w * 0.03)。
- 字体路径必须存在，Windows用
C:/Windows/Fonts/msyh.ttc，macOS用/System/Library/Fonts/Helvetica.ttc，Linux常见/usr/share/fonts/truetype/dejavu/DejaVuSans.ttf - 中文要显式指定字体，
ImageFont.truetype()不传size参数会报IOError - 文字颜色用RGBA元组，比如
(255, 255, 255, 128)，第四个值控制透明度（0–255）
批量处理时用os.listdir()不如pathlib.Path.glob()
os.listdir()返回无序文件名列表，遇到千张图容易漏掉扩展名不统一的文件（比如.JPG和.jpg混存）。pathlib.Path("input_dir").glob("*.jpg")能链式调用.resolve()和.stem，还能用**/*.jpg递归匹配子目录。
更关键的是错误隔离：单张图损坏（如EXIF异常）不该让整个脚本崩掉。用try/except OSError包住Image.open()，记录失败路径到error_log.txt，继续下一张。
立即学习“Python免费学习笔记（深入）”；
让 macOS 自动化像说话一样简单 —— 用代码控制你的 Mac，无需学习 AppleScript 系统要求 macOS 14+ (Sonoma) Python 3.9+ 需要开启：辅助功能 + 屏幕录制权限
- 避免用
for file in os.listdir(): if file.endswith(".jpg"):——忽略大小写会漏文件 - 输出路径建议用
input_path.with_name(f"wm_{input_path.stem}").with_suffix(".jpg")，保持原始目录结构 - 别在循环里反复打开/关闭同一个字体文件，提前加载一次复用
加透明PNG logo比文字水印更难搞清楚坐标
纯色文字能靠ImageDraw.text()自动对齐，但PNG logo要自己算位置+处理alpha通道。核心是三步：logo = Image.open("logo.png").convert("RGBA") → resized = logo.resize((int(w*0.15), int(h*0.15))) → background.paste(resized, (x, y), resized)。最后那个resized作为mask参数不能省，否则透明区域变成黑块。
容易踩的坑是logo尺寸固定写死，导致在手机竖图上水印过大、在横幅图上过小。按长边比例缩放更安全：scale = min(w, h) * 0.15 / max(logo_w, logo_h)。
- 如果logo本身带白底，先用
logo.split()[-1]提取alpha通道做mask - 位置坐标
(x, y)建议用右下角：(w - resized.width - 20, h - resized.height - 20) - 别用
Image.blend()，它要求两张图尺寸严格一致，不适合贴标场景
处理速度慢？别急着换OpenCV，先关掉JPEG压缩重采样
默认image.save("out.jpg", quality=75)会触发PIL内部重采样，千张图耗时翻倍。实测关掉优化选项能提速40%：image.save("out.jpg", quality=95, subsampling=0)。注意subsampling=0仅对JPEG有效，PNG不用管。
真正卡顿往往来自磁盘I/O——同一目录读写频繁触发系统缓存抖动。把输入输出目录分开放，比如input/和output/，能明显改善。
- 不要用
image.convert("RGB").save()强行转模式，原图是RGB就别多此一举 - 批量时禁用
exif保留（save(..., exif=b"")），否则每张图都要解析EXIF数据 - Python多进程（
multiprocessing.Pool）对CPU密集型任务有效，但要注意PIL线程不安全，必须用spawn启动方式
水印位置、字体大小、透明度这些参数看着琐碎，其实只要定好一套相对比例规则，就能适配从手机截图到印刷级图片的所有尺寸。真正麻烦的是那些没报错但效果诡异的图——比如CMYK模式的TIFF、带旋转标记的JPEG、超大尺寸的WebP，得单独加分支判断。
