根本原因是未正确创建字体对象或字体路径无效，必须用imagefont.truetype()指定真实可读字体；中文需选含对应字形的字体，水印应通过rgba图层合成实现半透明，批量处理须规范路径、及时释放内存并分批执行。
为什么直接用 ImageDraw.text() 往图片上写字容易糊、偏移或不显示
常见现象是文字极小、全黑一片、坐标错位，甚至报 TypeError: cannot unpack non-iterable NoneType object。根本原因不是函数用错了，而是没提前创建字体对象或用了系统默认字体（很多 Linux/macOS 环境下压根没加载成功）。ImageDraw.text() 必须配合 ImageFont.truetype() 使用，且路径必须真实可读。
实操建议：
- 别依赖
ImageFont.load_default()—— 它只支持 ASCII 且字号固定为 10，中文直接失败 - Windows 推荐用
C:/Windows/Fonts/msyh.ttc（微软雅黑），macOS 用/System/Library/Fonts/PingFang.ttc，Linux 建议拷贝一个DejaVuSans.ttf到项目目录 - 用
os.path.exists()检查字体路径，避免静默失败 - 字号别写死
size=12，批量处理不同分辨率图时，建议按图宽比例算：比如int(img.width * 0.03)
如何让水印文字自动适配图片尺寸并保持半透明叠加
硬编码坐标（如 (10, 10)）在批量处理中很快崩盘——小图被遮挡主体，大图水印缩成点。更可靠的做法是用 ImageDraw.textbbox() 先测文字区域，再结合锚点计算位置；透明度则不能靠 fill 参数调 alpha（Pillow 的 fill 不接受 RGBA 元组里的 alpha），得走图层合成。
实操建议：
- 先用
draw.textbbox(xy, text, font=font)获取包围盒，再算居中坐标：x = (img.width - bbox[2] + bbox[0]) // 2 - 不要直接在原图上 draw —— 创建新图层：
layer = Image.new('RGBA', img.size, (0, 0, 0, 0))，然后draw_layer = ImageDraw.Draw(layer) - 写文字时
fill=(255, 255, 255, 64)（最后一位是 alpha，0–255），再用Image.alpha_composite(img.convert('RGBA'), layer) - 如果原图无 alpha 通道（如 JPEG），最终保存前要转回 RGB：
result.convert('RGB')，否则保存失败
批量处理时如何避免内存爆掉或覆盖原文件
一次 load 几百张图进内存，又不显式 del img 或 close()，很容易触发 MemoryError；而用 input_path.replace('.jpg', '_watermarked.jpg') 这种字符串替换，遇到 photo_v2.jpg 就会误写成 photo_v2_watermarked.jpg，逻辑错误。
实操建议：
- 用
pathlib.Path处理路径：out_path = input_path.parent / f"{input_path.stem}_wm{input_path.suffix}" - 每张图处理完立刻
img.close()，文字图层也及时del layer, draw_layer - 加
try/except包住单张图处理逻辑，出错跳过并打印文件名，别让整个批次中断 - 如果图多，考虑用
glob分批（如每次 20 张）或加time.sleep(0.01)缓冲磁盘 I/O
中文水印出现方块或乱码的真正原因和修复方式
不是编码问题，也不是字体没选对——90% 是字体文件本身不包含你要打的字形。比如用「思源黑体」简体版打繁体字，或用英文 ttf 打中文，textbbox() 可能返回空元组，text() 就画不出东西，还可能引发后续坐标计算崩溃。
实操建议：
- 用
font.getmetrics()和font.getmask('测试').size验证字体是否真能渲染中文 - 优先选带「CN」「SC」「GB」后缀的字体，例如
NotoSansCJKsc-Regular.otf - 临时调试时，先用一个确定支持中文的字体（如从 Windows 拷
simhei.ttf）跑通流程，再换目标字体 - 别信网上“改 encoding 参数就能解决”的说法——Pillow 4.0+ 已不支持
encoding参数，传了也忽略
批量加水印真正卡点不在代码长短，而在字体路径可靠性、图层 alpha 合成顺序、以及中文字符集匹配这三处。漏查任意一项，都可能让脚本在第 37 张图上静默失败。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
