如何使用 PIL 和 qrcode 库将 QR 码背景设为透明

碧海醫心 2026-01-06 00:00:00 次阅读

本文详解如何在 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