qrcode.make()生成的图无法直接贴背景,因其默认返回模式为"1"(1-bit黑白),与rgb/rgba背景图模式不匹配,易报错或显示黑块;须用qrcode实例+make_image()并convert("rgba")。

为什么直接用 qrcode.make() 生成的图没法直接贴背景
因为 qrcode.make() 默认返回的是 PIL Image 对象,但它的模式通常是 "1"(1-bit 黑白),而 Pillow 合成背景图时要求图层模式一致(比如背景是 "RGB",二维码也得转成 "RGB" 或 "RGBA")。不转就报错:ValueError: images do not match,或者合成后全是黑块。
实操建议:
- 始终用
qrcode.QRCode实例 +make_image(),别偷懒用qrcode.make() - 生成时显式指定
back_color和fill_color,避免依赖默认值 - 立刻转成
"RGBA"模式:qr_img = qr_img.convert("RGBA")
如何把二维码居中贴到背景图上(不是简单 paste())
Image.paste() 的坐标是左上角,但人眼认的“居中”是按二维码图像中心对齐背景图中心。手动算坐标容易错,尤其当二维码尺寸没对齐背景宽高时。
实操建议:
- 先获取背景图尺寸:
bg_w, bg_h = background.size - 再获取二维码尺寸:
qr_w, qr_h = qr_img.size - 计算粘贴左上角坐标:
(int((bg_w - qr_w) / 2), int((bg_h - qr_h) / 2)) - 务必传
mask=qr_img参数(尤其二维码有透明底时),否则白底会盖掉背景:background.paste(qr_img, pos, mask=qr_img)
合成时文字/Logo压不住二维码?顺序和图层模式是关键
很多人加完二维码再贴 Logo,结果 Logo 被二维码“吃掉”——其实是图层叠加顺序错了。PIL 是顺序绘制:先 paste 的在底层,后 paste 的在上层。另外,如果 Logo 是 PNG 但没带 alpha 通道,mask 参数无效,白边会糊掉二维码边缘。
让 macOS 自动化像说话一样简单 —— 用代码控制你的 Mac,无需学习 AppleScript 系统要求 macOS 14+ (Sonoma) Python 3.9+ 需要开启:辅助功能 + 屏幕录制权限
实操建议:
- 贴图顺序必须是:背景 → 二维码 → Logo → 文字(如有)
- 加载 Logo 后强制转
"RGBA":logo = Image.open("logo.png").convert("RGBA") - 缩放 Logo 前先算比例,避免拉伸变形:
logo = logo.resize((int(qr_w * 0.25), int(qr_h * 0.25)), Image.Resampling.LANCZOS) - 文字用
ImageDraw.Draw().text(),字体路径必须存在,否则静默失败(不报错但没字)
导出文件时模糊、锯齿、颜色偏移怎么办
常见现象:二维码扫不出来、背景图发灰、边缘毛刺。根源往往是图像模式不匹配或保存参数不合理。PNG 默认用 optimize=True 可能丢 alpha;JPEG 不支持透明,强行保存会把透明区变黑;分辨率太低(box_size=10 太小)导致扫描失败。
实操建议:
- 最终图统一转
"RGB"再存 JPEG,或保持"RGBA"存 PNG - PNG 保存加
optimize=False, compress_level=1避免压缩失真 - 二维码最小推荐
box_size=15(对应约 300×300 px),手机扫码才稳 - 别用
save(..., quality=75)存 PNG——这个参数只对 JPEG 有效
复杂点往往卡在模式转换和 mask 使用时机上,多打一行 print(img.mode, img.size) 能省两小时调试时间。
Python免费学习笔记(深入):立即使用
在学习笔记中,你将探索 Python 的核心概念和高级技巧!










