根本原因是未指定字体路径，Pillow 默认找不到系统字体；应使用 importlib.resources 加载内置字体、动态计算文本尺寸、单字符绘制并加随机旋转、缓存字体对象、正确返回 PNG 字节流。
验证码图片生成失败：Pillow draw.text() 报错 IOError: cannot open resource
根本原因是没指定字体路径，Pillow 默认找不到系统字体。Linux/macOS 通常压根没预装 arial.ttf 这类 Windows 常见字体，直接写死路径必挂。
- 用
ImageFont.truetype()时，必须传一个真实存在的字体文件路径，不能只写字体名 - 推荐用
pkg_resources或importlib.resources（Python 3.9+）把字体文件打进包里，比如放fonts/DejaVuSans.ttf，然后用importlib.resources.files(__package__).joinpath("fonts/DejaVuSans.ttf")拿路径 - 临时调试可用系统自带字体：macOS 是
/System/Library/Fonts/Helvetica.ttc，Ubuntu 是/usr/share/fonts/truetype/dejavu/DejaVuSans.ttf，但别上线硬编码
验证码字符粘连、识别率高：draw.text() 位置和字号控制不当
默认字号太小、字符间距太近，人眼都难分清，更别说防 OCR；但字号太大又撑出画布，或笔画过粗导致粘连——这不是“越乱越好”，而是要平衡可读性与机器识别难度。
- 建议字号在
24–32之间，用font.getbbox(text)（Pillow 8.0+）或font.getsize(text)（旧版）动态算宽高，别用固定偏移 - 每个字符单独
draw.text((x, y), char, fill=color, font=font)，x 坐标按字符宽度累加，留6–10像素间隔，避免挤在一起 - 加一点随机旋转（
angle = random.randint(-15, 15)），再用text_img = text_img.rotate(angle, expand=1)后贴回，比整图扭曲更自然
接口返回空白图或 Content-Type 错误：HTTP 响应体没正确构造
Flask/FastAPI 返回的是字节流，不是文件路径；Content-Type 写成 text/plain 或漏设，浏览器就当文本渲染，显示一堆乱码。
macOS UI 自动化技能包 —— 用 Python 控制你的 Mac
下载
让 macOS 自动化像说话一样简单 —— 用代码控制你的 Mac，无需学习 AppleScript 系统要求 macOS 14+ (Sonoma) Python 3.9+ 需要开启：辅助功能 + 屏幕录制权限
- 用
BytesIO接收image.save(buf, format="PNG")的输出，再用buf.getvalue()拿 bytes - 响应头必须设
Content-Type: image/png（PNG）或image/jpeg（JPEG），别依赖框架自动推断 - FastAPI 用
Response(content=buf.getvalue(), media_type="image/png")；Flask 用send_file(buf, mimetype="image/png", as_attachment=False)，注意as_attachment=False否则会下载
生成速度慢、并发扛不住：每次调用都新建 ImageFont 实例
ImageFont.truetype() 是重操作，内部要解析字体文件、构建 glyph 缓存。每生成一个验证码都调一次，QPS 上不去，CPU 也虚高。
立即学习“Python免费学习笔记（深入）”；
- 字体对象是线程安全的，全局缓存一份即可：
FONT = ImageFont.truetype(font_path, size=28)放模块顶层 - 如果支持多字号（比如干扰线用小号字），最多缓存 2–3 个常用尺寸，别按需 new
- 验证码图大小统一（如
(120, 40)），就提前建好Image.new("RGB", (120, 40))模板复用，但注意别跨请求共享 Image 实例（有状态）
真正麻烦的是噪声与字体的博弈：加太多点线，人眼识别率掉得比机器还快；加太少，tesseract 一行命令就 OCR 出来。没有银弹，得拿真实用户反馈调参，而不是只看“看起来乱”。
