Python生成二维码合成背景图教程

本文详解了Python中使用qrcode库生成高质量二维码并精准合成背景图的核心技巧，直击开发者常踩的“黑块”“报错”“居中失准”“Logo被覆盖”“扫码失败”等痛点，强调必须用QRCode实例配合make_image()并显式convert("RGBA")解决图像模式不匹配问题，提供居中定位、分层叠加（背景→二维码→Logo→文字）、抗锯齿缩放、字体加载及PNG/JPEG导出避坑指南，所有建议均基于真实调试经验，助你一次性生成清晰、美观、可稳定扫描的定制化二维码图片。

为什么直接用 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 参数无效，白边会糊掉二维码边缘。

实操建议：

• 贴图顺序必须是：背景 → 二维码 → 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生成二维码合成背景图教程》的详细内容，更多关于的资料请关注golang学习网公众号！