Python生成二维码技巧，qrcode库使用教程

使用qrcode库生成二维码最直接有效，需先安装qrcode和Pillow：pip install qrcode Pillow；2. 基础用法为qrcode.make(data)生成并保存图片；3. 高级定制可通过QRCode类设置version、error_correction、box_size、border等参数；4. 添加Logo需借助Pillow将二维码转为RGBA模式，调整Logo尺寸并居中粘贴，且必须设置error_correction=ERROR_CORRECT_H以确保可识别；5. 二维码扫不出来常见原因包括纠错级别过低、Logo过大、数据量过大导致密集、颜色对比度不足、边框不足、物理尺寸过小或扫描器问题，应依次排查这些因素；最终生成的二维码图片可通过img.save()保存，整个流程结合qrcode与Pillow实现高效定制化输出。

Python制作二维码，最直接、最常用且效果非常好的方式，就是利用 qrcode 库。它提供了一套简洁而强大的API，能让你轻松地将文本、链接，甚至是复杂的JSON数据转换成可扫描的二维码图片。这个库用起来非常直观，几乎是Python处理二维码的首选。

解决方案

要使用 qrcode 库，你得先安装它： pip install qrcode Pillow 这里多加了一个Pillow，因为qrcode生成图片时底层会用到它，直接装上省得后面报错。

最基础的用法，生成一个包含特定信息的二维码图片：

import qrcode

# 你想编码的信息
data = "https://www.example.com"

# 最简单的生成方式
img = qrcode.make(data)

# 保存图片
img.save("my_simple_qrcode.png")

print("简单的二维码已生成：my_simple_qrcode.png")

如果你想对二维码的样式做些调整，比如改变颜色、大小或者纠错级别，qrcode.QRCode类会给你更多控制权。这就像是给二维码“定制西装”的过程。

import qrcode
from qrcode.constants import ERROR_CORRECT_H # 导入纠错级别常量

data = "https://www.another-example.com/long-url-test"

# 创建一个QRCode对象，并设置参数
qr = qrcode.QRCode(
    version=1,  # 控制二维码的大小（1-40），数字越大，能存储的信息越多，二维码也越大。
                # None表示库会自动选择合适的版本。
    error_correction=ERROR_CORRECT_H, # 纠错级别，H是最高级别，能容忍约30%的损坏。
                                      # L, M, Q, H，级别越高，冗余越多，二维码越密。
    box_size=10, # 每个二维码“小方块”的像素大小。
    border=4,    # 二维码边框的宽度（以box_size为单位）。至少4个单位的边框是标准。
)

# 添加数据
qr.add_data(data)
qr.make(fit=True) # 确保所有数据都适配到二维码中

# 生成图片
# fill_color和back_color可以设置二维码的颜色
img = qr.make_image(fill_color="black", back_color="white")

# 保存图片
img.save("my_custom_qrcode.png")

print("定制的二维码已生成：my_custom_qrcode.png")

version=None通常是个不错的默认选择，让库自己去算最合适的尺寸。但如果你对尺寸有严格要求，比如要放到名片上，可以手动调整。

为什么选择qrcode库？它有哪些优势？

选择 qrcode 库，对我个人而言，最主要的原因就是它的“恰到好处”。市面上生成二维码的库不少，但 qrcode 在易用性和功能深度之间找到了一个很好的平衡点。你不需要深入了解二维码的底层编码原理，就能快速上手；同时，它又提供了足够的定制化选项，满足大部分日常需求。

它的优势很明显：

• 极简主义的API设计： qrcode.make()一行代码就能搞定，这对于快速原型开发或者只需要一个简单二维码的场景来说，简直是福音。
• 高度可定制： 从纠错级别、尺寸、边框到颜色，甚至每个小方块的像素大小，你都能精确控制。这让生成的二维码能更好地融入你的设计。
• 成熟稳定： 这个库已经存在相当长一段时间了，经过了大量实践验证，bug少，社区支持也比较活跃。遇到问题，基本都能找到答案。
• 与Pillow（PIL）无缝集成： qrcode 生成的图片对象就是Pillow的Image对象，这意味着你可以很方便地利用Pillow的强大功能对二维码图片进行二次处理，比如加水印、缩放、裁剪，甚至合并到其他图片上。这点非常重要，尤其是当你需要给二维码中间加个Logo的时候。

我记得有一次，我需要批量生成带公司Logo的员工二维码，qrcode配合Pillow简直是神来之笔，效率一下子就上去了，比手动PS快了不知道多少倍。

如何为二维码添加Logo或定制样式？

给二维码中间加Logo是常见的需求，能提升品牌识别度。qrcode本身没有直接提供“加Logo”的功能，但因为它的输出是Pillow的Image对象，我们完全可以借助Pillow来完成这个操作。这其实是一个很经典的图像处理流程。

核心思路是：先生成二维码，再把Logo图片粘贴到二维码的中心位置。

import qrcode
from PIL import Image # 导入Pillow库

# 1. 配置二维码参数
qr = qrcode.QRCode(
    version=None, # 自动选择版本
    error_correction=qrcode.constants.ERROR_CORRECT_H, # 纠错级别设为最高，以便容纳Logo
    box_size=10,
    border=4,
)

# 2. 添加数据并生成二维码图片
qr.add_data("https://www.your-company.com/product-page")
qr.make(fit=True)
img_qr = qr.make_image(fill_color="black", back_color="white").convert("RGBA") # 转换为RGBA模式，方便粘贴透明Logo

# 3. 加载Logo图片
try:
    img_logo = Image.open("your_logo.png").convert("RGBA") # 确保Logo是RGBA模式，支持透明度
except FileNotFoundError:
    print("Logo文件未找到，请确保 'your_logo.png' 存在于当前目录。")
    exit()

# 4. 计算Logo的尺寸和位置
# Logo通常应该占二维码总面积的10%-30%左右，过大可能影响识别
qr_width, qr_height = img_qr.size
logo_width, logo_height = img_logo.size

# 调整Logo尺寸：这里我通常会根据二维码的尺寸来决定Logo的最终尺寸
# 比如，让Logo的宽度是二维码宽度的1/4到1/5
logo_target_width = qr_width // 4
logo_target_height = int(logo_target_width * (logo_height / logo_width)) # 按比例缩放高度

img_logo = img_logo.resize((logo_target_width, logo_target_height), Image.LANCZOS) # LANCZOS是高质量缩放算法

# 计算粘贴位置：居中
pos_x = (qr_width - logo_target_width) // 2
pos_y = (qr_height - logo_target_height) // 2

# 5. 将Logo粘贴到二维码上
img_qr.paste(img_logo, (pos_x, pos_y), img_logo) # 使用img_logo作为mask，支持透明Logo

# 6. 保存最终的二维码图片
img_qr.save("qrcode_with_logo.png")

print("带Logo的二维码已生成：qrcode_with_logo.png")

这里有个小细节，error_correction设置为ERROR_CORRECT_H（最高纠错级别）非常重要。因为Logo会遮挡一部分二维码图案，如果纠错级别不够高，二维码可能就无法被识别了。我曾经就犯过这个错误，Logo加进去后怎么都扫不出来，后来才发现是纠错级别太低，二维码的冗余信息不足以弥补被Logo遮挡的部分。

生成的二维码扫不出来怎么办？常见问题与排查

这是个非常实际的问题，尤其是在批量生成或者首次尝试的时候。二维码扫不出来，往往不是库本身的问题，而是参数设置或者使用场景导致的。我总结了一些常见的“坑”和排查方法：

1. 纠错级别太低（或Logo太大）：

   • 问题： 这是最常见的原因。如果你加了Logo，但error_correction不是H，或者Logo尺寸过大，覆盖了太多关键区域，二维码就可能无法识别。
   • 排查：
     • 将error_correction设置为qrcode.constants.ERROR_CORRECT_H。
     • 暂时移除Logo，看看裸二维码能否识别。如果可以，说明Logo尺寸或位置有问题，尝试缩小Logo。
     • 二维码标准规定Logo不应超过总面积的30%，实际使用中15%-20%更稳妥。

2. 数据量过大导致二维码过于密集：

   • 问题： 如果你编码的文本或URL非常长，qrcode库会自动选择更高的version，这会导致二维码图案非常密集，像素点很小。在低分辨率屏幕上显示或打印出来后，小像素点容易模糊，难以识别。
   • 排查：
     • 尝试缩短编码的数据。
     • 增加box_size参数，让每个小方块更大，提高物理尺寸。
     • 确保打印时有足够的分辨率。

3. 颜色对比度不足：

   • 问题： fill_color和back_color设置得太接近，例如浅灰色背景上的白色图案，或者深蓝色背景上的黑色图案，扫描器很难区分。
   • 排查： 确保前景和背景有足够的对比度，经典组合是黑白。如果需要彩色，确保颜色差异足够大。

4. 边框（Quiet Zone）不足：

   • 问题： 二维码标准要求周围必须有一圈空白区域（Quiet Zone），通常是二维码box_size的4倍宽度。如果border参数设置得太小，或者图片被裁剪掉了边框，扫描器可能无法定位二维码。
   • 排查： 确保border参数至少为4。保存图片后，不要随意裁剪图片边缘。

5. 物理尺寸太小或打印模糊：

   • 问题： 即使二维码本身生成得没问题，如果打印出来尺寸过小，或者打印机精度不够，导致像素点糊在一起，也会扫不出来。
   • 排查： 增加box_size参数，生成更大的图片。打印前预览，确保清晰度。

6. 扫描器问题：

   • 问题： 极少数情况下，可能是扫描App或设备的问题。
   • 排查： 尝试用不同的手机、不同的扫描App（比如微信、支付宝、系统相机等）进行测试。

遇到扫不出来的情况，我的经验是先从最简单的、最容易出问题的地方开始排查：纠错级别、Logo尺寸、以及颜色对比度。这些往往是问题的症结所在。