Python案例如何生成二维码图片？

wen python案例 2026-06-10 10

本文目录导读：

Python案例如何生成二维码图片？

目录导读
背景与需求：为什么需要自己写代码生成二维码？
核心库选择：哪个Python库最适合你？
5行代码生成基础二维码：连小学生都能学会
进阶案例：带Logo、彩色、动态二维码
常见错误与排错指南
SEO优化策略：让二维码图片被搜索引擎收录
问答环节：用户最关心的3个问题

Python案例实战：如何用5行代码生成个性化二维码图片？从入门到SEO优化全攻略

目录导读

背景与需求：为什么需要自行生成二维码？
核心库选择：qrcode vs MyQR vs 其他
5行代码生成基础二维码：零基础也能上手
进阶案例：带Logo、彩色、动态二维码
常见错误与排错指南：二维码扫码失败怎么办？
SEO优化策略：如何让二维码图片在搜索引擎中被收录？
问答环节：用户最关心的3个问题

背景与需求：为什么需要自己写代码生成二维码？

二维码已经成为连接线上线下的核心工具——无论是微信支付、产品溯源还是活动报名，但第三方在线生成工具通常存在三大痛点：

隐私风险：敏感数据（如URL含Token）可能被第三方记录。
样式固化：无法定制Logo、颜色、形状。
批量生成：手动操作数千个二维码效率极低。

通过Python编程实现二维码生成,已成为开发者和运营人员的必备技能，下面，我们将通过真实案例，一步步教会你从零开始。

核心库选择：哪个Python库最适合你？

库名	特点	适用场景
qrcode	纯Python实现，无第三方依赖，支持自定义颜色、边框、容错率	基础二维码、批量生成、高兼容性需求
MyQR	支持动态二维码（GIF）、背景图嵌入	社交媒体传播、营销活动
pyqrcode	轻量级，生成SVG格式	Web应用、向量图需求
segno	支持Micro QR码、高压缩率	嵌入式设备、小尺寸场景

推荐组合：日常开发用qrcode + Pillow（处理Logo）；营销场景用MyQR。

安装命令（建议使用Python 3.8+）：

pip install qrcode pillow myqr

5行代码生成基础二维码：连小学生都能学会

案例1：生成纯色二维码并保存

import qrcode
# 核心数据：可替换为任何URL或文本
data = "https://www.example.com/product?id=2025"
# 生成二维码对象（参数：容错率L/M/Q/H，默认M，建议用H）
img = qrcode.make(data)
# 保存为PNG图片
img.save("basic_qr.png")

运行后,你会在当前目录得到一个清晰可扫的二维码，注意，qrcode.make()默认返回一个PIL Image对象，因此可以直接调用.save()方法。

案例2：添加控制参数（颜色、大小、边框）

import qrcode
from qrcode.image.styledpil import StyledPilImage
from qrcode.image.styles.moduledrawers import RoundedModuleDrawer
qr = qrcode.QRCode(
    version=1,  # 1-40，控制二维码尺寸，越大能容纳数据越多
    error_correction=qrcode.constants.ERROR_CORRECT_H,  # H级容错（约30%损坏仍可读）
    box_size=10,
    border=4,   # 白边宽度，单位：box_size倍数
)
qr.add_data("https://www.example.com")
qr.make(fit=True)
# 生成带圆角模块的二维码
img = qr.make_image(
    image_factory=StyledPilImage,
    module_drawer=RoundedModuleDrawer(),
    fill_color="purple",  # 前景色
    back_color="yellow"   # 背景色
)
img.save("styled_qr.png")

关键参数解析：

version：数字越大，矩阵越密集，能存储的字符数越多，例如version=1最多存储25个数字字符，version=10可存储1384个数字。
error_correction：H级允许二维码被遮挡30%区域仍可识别，适合贴在产品包装上可能被磨损的场景。

进阶案例：带Logo、彩色、动态二维码

案例3：在二维码中心嵌入Logo

import qrcode
from PIL import Image
# 生成基础二维码
qr = qrcode.QRCode(version=5, error_correction=qrcode.constants.ERROR_CORRECT_H)
qr.add_data("https://www.yourdomain.com")
qr.make(fit=True)
img_qr = qr.make_image(fill_color="darkblue", back_color="white").convert("RGB")
# 打开Logo图片（建议200x200像素，透明背景PNG）
logo = Image.open("logo.png")
# 计算Logo尺寸（二维码25%大小）
qr_width, qr_height = img_qr.size
logo_size = int(min(qr_width, qr_height) * 0.25)
logo = logo.resize((logo_size, logo_size))
# 计算粘贴位置（居中）
pos = ((qr_width - logo_size) // 2, (qr_height - logo_size) // 2)
img_qr.paste(logo, pos, logo)  # 第三个参数是mask，支持透明
img_qr.save("logo_qr.png")

注意事项：

Logo尺寸不能超过二维码面积的30%，否则可能影响识别。
建议使用透明背景的PNG,避免白色方块遮挡二维码数据。
若出现打印后无法扫码,可尝试将Logo尺寸缩小到20%以下。

案例4：生成动态GIF二维码（使用MyQR库）

from MyQR import myqr
# 参数：words（数据）、picture（背景图）、colorized（是否彩色）、save_name
myqr.run(
    words="https://www.example.com",
    picture="background.gif",   # 支持GIF背景，生成动态二维码
    colorized=True,            # 彩色模式
    save_name="dynamic_qr.gif",
    save_dir="./output"
)

注意：MyQR在2023年后更新较少，建议对GIF场景先测试兼容性，如果遇到ModuleNotFoundError，请确保安装时指定了myqr而非MyQR（大小写敏感）。

常见错误与排错指南

错误1：`qrcode`生成后扫码提示“无效二维码”

原因：数据过长（超过版本限制）或容错率过高（H级只能容纳更少数据）。
解决：自动设置qr = qrcode.QRCode(version=None)让库自动计算最佳版本；或限制数据长度在1000字符内。

错误2：带Logo的二维码扫码后报错“解析失败”

原因：Logo区域的纠错数据被覆盖。
解决：确保error_correction=ERROR_CORRECT_H，且Logo尺寸不超过二维码边长的30%。

错误3：生成的二维码背景色为白色，但输出文件是纯黑色

原因：fill_color和back_color参数未正确传递。
解决：使用img = qr.make_image(fill_color="red", back_color="blue")，并确认Pillow版本>8.0。

错误4：`myqr`安装后无法导入

原因：库名大小写混淆。
解决：pip install myqr后，导入时使用from MyQR import myqr（注意首字母大写）。

SEO优化策略：让二维码图片被搜索引擎收录

很多人忽略了一个关键点：二维码图片本身也可以被Google或Bing索引，从而带来额外流量，以下是提升收录率的4个技巧：

Alt标签必填：在HTML中引入二维码时，添加描述性文字。

<img src="qr_wechat.png" alt="微信扫码关注公众号：Python技术指南">

文件名语义化：避免qr1.png，改用python-qr-code-tutorial-logo.png。
图片尺寸与分辨率：建议至少500x500像素，同时提供响应式版本（srcset）。

结构化数据标记：使用ImageObject Schema标记，告诉搜索引擎这是可索引图片。

{
  "@context": "https://schema.org",
  "@type": "ImageObject",
  "contentUrl": "https://www.yourdomain.com/qr/wx.png",
  "description": "微信二维码，扫描后访问Python教程"
}

注意：不要将二维码作为唯一导航方式，必须同时提供纯文本链接，以避免搜索引擎无法抓取内容。

问答环节：用户最关心的3个问题

Q1：生成的二维码能用防伪吗？比如加入不可见水印？

A：标准二维码协议不内置防伪功能，但可通过以下方法实现：

利用容错空间,在部分模块中嵌入微小的颜色差异（肉眼不可见，但需专用设备读取）。
增加URL中的参数（如https://example.com?uid={唯一ID}），服务端验证参数有效性。
使用支持数字签名的二维码（如Beetle QR码），但兼容性较差。

Q2：如何批量生成1000个不同的二维码？

A：使用循环+数据源（CSV/Excel）即可：

import csv
import qrcode
with open("urls.csv") as f:
    reader = csv.reader(f)
    for i, row in enumerate(reader):
        url = row[0]
        qrcode.make(url).save(f"qr_{i}.png")

建议添加进度条（tqdm库）和异常处理，避免某个URL异常导致程序中断。