本文详解如何在 python 中生成带透明背景的 qr 码，解决 `qrcode.make_image()` 默认黑底问题，通过正确设置 `back_color="transparent"` 并配合 rgba 模式保存，实现真正透明输出。
在使用 qrcode 库生成图像时，一个常见误区是认为将 back_color 设为 None 或省略即可获得透明背景——但实际上，qrcode 的 make_image() 方法不支持 None 作为 back_color 值，且默认会渲染为不透明黑色背景。真正的解决方案非常简洁：显式传入字符串 "transparent"。
修改你原代码中的关键一行即可：
# ❌ 错误写法（back_color=None 会被忽略，回退为黑色） img = qr.make_image(fill_color=(255, 255, 255), back_color=None) # ✅ 正确写法（明确指定透明背景） img = qr.make_image(fill_color=(255, 255, 255), back_color="transparent")
⚠️ 注意事项：
- back_color="transparent" 要求底层图像模式支持 Alpha 通道，因此 qrcode 内部会自动创建 RGBA 图像（无需手动转换）；
- 后续若需叠加文字或合成到其他图像，确保 final_img 也使用 'RGBA' 模式（你当前代码中已正确使用 Image.new('RGBA', ...)，这点很好）；
- 保存为 PNG 格式才能保留透明度（JPEG 不支持 Alpha），例如 output_path 应为 .png 文件路径；
- 若后续需嵌入 PDF（如用 fpdf2），注意多数 PDF 库仅支持 RGB；此时可先将透明 QR 码合成到白色/浅色背景再转 RGB，或改用支持透明 PNG 的 PDF 库（如 reportlab）。
完整修正后的核心片段如下：
def generate_qr_code_with_text(data, text_row1, text_row2, text_row3, output_path, qr_size_pixels=227):
try:
qr = qrcode.QRCode(
version=1,
error_correction=qrcode.constants.ERROR_CORRECT_L,
box_size=10,
border=4,
)
qr.add_data(data)
qr.make(fit=True)
# ✅ 关键修复：使用 "transparent" 字符串
img = qr.make_image(fill_color=(255, 255, 255), back_color="transparent")
img = img.resize((qr_size_pixels, qr_size_pixels))
# 保持 RGBA 模式以维持透明度
final_img = Image.new('RGBA', (img.width, img.height + 90), color=(255, 255, 255, 0))
final_img.paste(img, (0, 0))
draw = ImageDraw.Draw(final_img)
font = ImageFont.load_default()
# 文字绘制逻辑保持不变（文字为不透明黑色，不影响背景透明性）
y_offsets = [10, 30, 50]
for i, text in enumerate([text_row1, text_row2, text_row3]):
pos = (final_img.size[0] // 2, img.size[1] + y_offsets[i])
draw.text(pos, f"Row {i+1}: {text}", fill="black", font=font, anchor="mm")
# ✅ 务必保存为 PNG 以保留 Alpha 通道
final_img.save(output_path) # e.g., "qr_transparent.png"
return True
except Exception as e:
print(f"QR generation failed: {e}")
return False✅ 总结：只需将 back_color=None 改为 back_color="transparent"，并确保输出格式为 PNG，即可一键获得透明背景 QR 码。这是 qrcode 库原生支持的标准用法，无需额外图像处理或模式转换。
