用Python做二维码生成器|从入门到精通的实战指南

一、为什么用Python做二维码生成器?

二维码(QR Code)作为信息编码的通用载体,已深度融入移动支付、身份认证、电商营销、工业溯源等场景。相比其他语言,用Python做二维码生成器具有以下显著优势:

据2025年Q1数据,GitHub上Python二维码相关项目年增长达37%,其中qrcode库月下载量超120万次,成为开发者首选方案。

主流Python二维码库对比

库名称核心功能安装命令适用场景局限性
qrcode标准QR码生成,支持版本1-40、纠错等级L/M/Q/Hpip install qrcode[pil]基础生成、静态美化不支持动态效果
myqr支持GIF/图片动图二维码、自定义背景图pip install MyQR营销海报、创意设计依赖PIL,部分GIF兼容性差
segno微码/汉信码/Data Matrix等多格式,支持编码优化pip install segno工业标签、高密度编码API较底层,学习曲线陡
pyzbar二维码解码识别,支持多码检测pip install pyzbar扫码验证、OCR前置处理需zbar库支持(Windows需手动安装)

二、环境搭建:三步完成Python二维码生成环境配置

无论Windows、macOS还是Linux,按以下步骤操作即可:

1. 安装Python 3.8+

访问python.org下载最新稳定版,安装时勾选"Add Python to PATH"。

2. 创建虚拟环境(推荐)

终端执行
python -m venv qrcode-env qrcode-env\Scripts\activate # Windows source qrcode-env/bin/activate # macOS/Linux

3. 安装核心依赖

终端执行
pip install qrcode[pil] pillow pyzbar opencv-python

说明:

验证安装是否成功:

终端执行
python -c "import qrcode; print('qrcode OK')" python -c "from PIL import Image; print('PIL OK')" python -c "from pyzbar.pyzbar import decode; print('pyzbar OK')"

三、基础生成:5分钟掌握核心API与参数

1. 生成最简二维码

示例:生成基础文本二维码
import qrcode # 创建二维码对象 qr = qrcode.QRCode( version=1, # 版本1:21x21模块 error_correction=qrcode.constants.ERROR_CORRECT_L, # 纠错等级L(7%) box_size=10, # 每个模块10像素 border=4 # 边框4模块 ) # 添加数据 qr.add_data("https://www.xservx.com") qr.make(fit=True) # 生成图片 img = qr.make_image(fill_color="black", back_color="white") img.save("basic_qr.png")

生成文件:basic_qr.png,扫描可跳转至网站主页。

2. 关键参数详解

Version
Error Correction
Box Size
Border
Data Types

version:二维码版本选择

取值1~40,对应尺寸公式:size = (version - 1) × 4 + 21。例如:

  • Version 1:21×21模块(最小)
  • Version 7:49×49模块(中等)
  • Version 40:177×177模块(最大)

当数据量大时,自动fit=True会升级版本。建议:文本≤200字符用version=1~3;URL用version=2~4。

error_correction:纠错等级

决定二维码损坏后可恢复程度:

等级缩写可恢复比例适用场景
最低L7%静态展示、低风险场景
默认M15%通用场景
高Q25%户外广告、易损载体
最高H30%医疗/工业关键信息

示例:医疗溯源二维码推荐H级,确保污损后仍可识别。

box_size:模块尺寸

单位:像素。值越大,二维码越清晰但占用空间越大。

  • 打印标签:box_size=10~15
  • 屏幕显示:box_size=20~30
  • 大屏展示:box_size=50+

注意:打印前需按物理尺寸校准。例如A4纸打印时,100×100mm二维码建议box_size=10,border=2。

border:边框大小

标准要求≥4模块(ISO/IEC 18004),过小可能导致识别失败。特殊场景可调整:

  • 嵌入背景图:border=0~2(需后处理加白边)
  • 嵌套显示:border=1~3(避免边缘干扰)

数据类型支持

用Python做二维码生成器可编码多种数据格式:

数据类型编码示例识别后效果
纯文本"Hello 二维码"直接显示
URL"https://www.xservx.com"手机自动跳转
WiFi"WIFI:S:MyHome;T:WPA;P:pass123;;"一键连接网络
名片"BEGIN:VCARD\nVERSION:3.0\nN:张;三;;;\nTEL:+8613800138000\nEND:VCARD"保存联系人
邮箱"mailto:admin@xservx.com?subject=反馈"打开邮件客户端

四、高级美化:让二维码兼具功能与美感

1. 自定义颜色方案

示例:渐变色二维码
from PIL import Image, ImageDraw # 生成基础二维码 qr = qrcode.QRCode(version=3, error_correction=qrcode.ERROR_CORRECT_H) qr.add_data("https://www.xservx.com") qr.make(fit=True) img = qr.make_image(fill_color="black", back_color="white") # 转为RGBA支持透明通道 img = img.convert("RGBA") # 创建渐变层 draw = ImageDraw.Draw(img) width, height = img.size # 纵向渐变:黑→蓝 for y in range(height): for x in range(width): pixel = img.getpixel((x, y)) if pixel[:3] != (255, 255, 255): # 非白色区域 # 计算蓝色分量(0~255) blue = int(y / height * 255) img.putpixel((x, y), (0, 0, blue, pixel[3])) img.save("gradient_qr.png")

效果说明:二维码中心为深蓝色,边缘过渡至黑色,背景保持白色以确保可读性。

2. 图片嵌入技术

示例:中心嵌入Logo
import qrcode from PIL import Image # 生成基础二维码 qr = qrcode.QRCode( version=5, error_correction=qrcode.ERROR_CORRECT_H, box_size=8, border=2 ) qr.add_data("https://www.xservx.com") qr.make(fit=True) qr_img = qr.make_image(fill_color="#037ef3", back_color="white").convert("RGBA") # 加载Logo logo = Image.open("logo.png").convert("RGBA") # 计算尺寸(二维码尺寸的20%) qr_width, qr_height = qr_img.size logo_size = int(min(qr_width, qr_height) * 0.2) logo = logo.resize((logo_size, logo_size), Image.LANCZOS) # 计算位置(中心) pos = ((qr_width - logo_size) // 2, (qr_height - logo_size) // 2) # 合成图像 qr_img.paste(logo, pos, logo) qr_img.save("logo_qr.png")

关键技巧:

3. 特殊形状生成

圆角矩形
圆形
自定义路径

圆角矩形二维码

通过掩膜(Mask)技术,将边缘模块替换为圆角设计:

核心逻辑
from qrcode import QRCode, constants qr = QRCode( version=3, error_correction=constants.ERROR_CORRECT_H, box_size=10, border=2 ) qr.add_data("https://www.xservx.com") qr.make(fit=True) # 获取模块矩阵 matrix = qr.get_matrix() # 创建新图像(白色背景) from PIL import Image, ImageDraw img = Image.new("RGBA", (len(matrix[0])*10, len(matrix)*10), (255,255,255,0)) draw = ImageDraw.Draw(img) # 绘制圆角矩形模块 for row_idx, row in enumerate(matrix): for col_idx, cell in enumerate(row): if cell: x = col_idx * 10 y = row_idx * 10 # 绘制圆角矩形(半径=3) draw.rounded_rectangle([x, y, x+10, y+10], radius=3, fill=(3,126,243,255)) img.save("rounded_qr.png")

圆形模块二维码

将每个黑色模块替换为圆形,提升艺术感:

关键代码
# 替换draw.rectangle为draw.ellipse draw.ellipse([x, y, x+10, y+10], fill=(3,126,243,255))

注意:圆形模块间空隙较大,需增加box_size至12以上避免重叠。

自定义路径(心形/星形)

使用PIL的Path类绘制任意形状轮廓,再填充二维码模块:

心形二维码示例
from PIL import Image, ImageDraw, ImagePath # 创建心形路径 path = ImagePath.Path([ (100, 100), (80, 60), (60, 100), (100, 180), (140, 100), (120, 60), (100, 100) ]) # 生成路径掩膜 img_mask = Image.new("L", (200, 200), 0) draw = ImageDraw.Draw(img_mask) draw.path(path, fill=255) # 生成二维码后应用掩膜 qr_img = qr.make_image(fill_color=(3,126,243,255), back_color=(255,255,255,0)) qr_img = qr_img.convert("RGBA") qr_img.putalpha(img_mask) qr_img.save("heart_qr.png")

适用场景:节日营销、品牌定制礼盒、创意纪念品。

五、批量生成:高效处理千级二维码

1. 基于CSV的批量方案

假设CSV文件urls.csv格式:

id,url,备注
001,https://www.xservx.com/about,公司简介
002,https://www.xservx.com/products,产品中心
003,https://www.xservx.com/contact,联系我们
批量生成脚本
import pandas as pd import qrcode from pathlib import Path # 创建输出目录 Path("output").mkdir(exist_ok=True) # 读取CSV df = pd.read_csv("urls.csv") for idx, row in df.iterrows(): # 生成二维码 qr = qrcode.QRCode(version=2, error_correction=qrcode.ERROR_CORRECT_M) qr.add_data(row['url']) qr.make(fit=True) img = qr.make_image(fill_color="#037ef3", back_color="white") # 保存(文件名含ID) filename = f"output/{row['id']}_qr.png" img.save(filename) print(f"生成 {filename} 成功") print("批量生成完成!共处理", len(df), "条记录")

执行结果:在output目录生成3个二维码图片,文件名含ID便于追溯。

2. 动态二维码(防伪升级版)

通过添加唯一ID实现防伪追踪:

动态二维码生成逻辑
import qrcode import hashlib import time def generate_dynamic_url(base_url, payload): """生成带时间戳和签名的动态URL""" timestamp = str(int(time.time())) signature = hashlib.md5(f"{payload}{timestamp}SECRET_KEY".encode()).hexdigest() return f"{base_url}?id={payload}&t={timestamp}&sig={signature}" # 生成示例 dynamic_url = generate_dynamic_url("https://www.xservx.com/verify", "PROD_2026_X") qr = qrcode.make(dynamic_url) qr.save("dynamic_qr.png")

验证端逻辑(Flask示例):

verify.py
from flask import Flask, request, jsonify import hashlib import time app = Flask(__name__) @app.route('/verify') def verify(): payload = request.args.get('id') timestamp = int(request.args.get('t')) signature = request.args.get('sig') # 验证时效(5分钟内有效) if time.time() - timestamp > 300: return jsonify({"status": "expired"}), 400 # 验证签名 expected_sig = hashlib.md5(f"{payload}{timestamp}SECRET_KEY".encode()).hexdigest() if signature != expected_sig: return jsonify({"status": "invalid"}), 403 return jsonify({"status": "valid", "product_id": payload}) if __name__ == '__main__': app.run(debug=True)

优势:

3. 打印友好型生成

针对A4标签打印机优化:

标签二维码生成
from PIL import Image, ImageDraw # 创建A4尺寸画布(2480×3508像素 @ 300dpi) a4 = Image.new("RGB", (2480, 3508), "white") draw = ImageDraw.Draw(a4) # 二维码参数 qr_size = 400 # 400×400像素 margin = 20 cols = 5 rows = 7 # 生成网格二维码 for row in range(rows): for col in range(cols): x = margin + col * (qr_size + margin) y = margin + row * (qr_size + margin) # 生成唯一数据 data = f"LABEL_{row*cols + col + 1}" qr = qrcode.make(data) qr = qr.resize((qr_size, qr_size), Image.LANCZOS) # 粘贴到画布 a4.paste(qr, (x, y)) # 添加文字说明 draw.text((x + qr_size//2 - 50, y + qr_size + 10), f"编号: {data}", fill="black") a4.save("print_labels.png")

输出文件可直接用于标签打印机(需配合标签软件定位)。

六、安全增强:防伪与加密实战

1. 二维码加密方案对比

方案原理安全性兼容性适用场景
URL跳转加密生成短链指向加密页面★★☆★★★★★通用营销
数据内加密QR码内存储AES加密内容★★★★★★内部系统
动态令牌基于时间的一次性密码(TOTP)★★★★★★☆身份认证
硬件绑定二维码含设备指纹★★★★★★★高价值资产

2. 实现AES加密二维码

加密生成脚本
from cryptography.hazmat.primitives.ciphers import Cipher, algorithms, modes from cryptography.hazmat.primitives import padding from cryptography.hazmat.backends import default_backend import base64 import qrcode def aes_encrypt(plaintext, key, iv): """AES-CBC加密(PKCS7填充)""" backend = default_backend() cipher = Cipher(algorithms.AES(key), modes.CBC(iv), backend=backend) encryptor = cipher.encryptor() # PKCS7填充 padder = padding.PKCS7(128).padder() padded_data = padder.update(plaintext.encode()) + padder.finalize() ciphertext = encryptor.update(padded_data) + encryptor.finalize() return base64.b64encode(ciphertext).decode() # 配置密钥(实际应存储在环境变量) KEY = b"0123456789abcdef" * 2 # 32字节AES-256 IV = b"abcdef9876543210" # 16字节IV # 加密数据 plaintext = "SECRET_CODE:2026-XSERV-X" ciphertext = aes_encrypt(plaintext, KEY, IV) # 生成二维码 qr = qrcode.make(ciphertext) qr.save("encrypted_qr.png")

解密验证脚本:

解密脚本
from cryptography.hazmat.primitives.ciphers import Cipher, algorithms, modes from cryptography.hazmat.primitives import padding from cryptography.hazmat.backends import default_backend import base64 def aes_decrypt(ciphertext, key, iv): """AES-CBC解密""" backend = default_backend() cipher = Cipher(algorithms.AES(key), modes.CBC(iv), backend=backend) decryptor = cipher.decryptor() # Base64解码 raw_ciphertext = base64.b64decode(ciphertext) # 解密 padded_plaintext = decryptor.update(raw_ciphertext) + decryptor.finalize() # 移除PKCS7填充 unpadder = padding.PKCS7(128).unpadder() plaintext = unpadder.update(padded_plaintext) + unpadder.finalize() return plaintext.decode() # 解密示例 with open("encrypted_qr.png", "rb") as f: # 实际需先用pyzbar读取二维码内容 # 此处简化为直接使用ciphertext变量 decrypted = aes_decrypt(ciphertext, KEY, IV) print("解密结果:", decrypted) # 输出: SECRET_CODE:2026-XSERV-X

安全要点:

3. 防伪验证系统架构

基于二维码的防伪流程:

  1. 生产端:生成唯一ID + 加密哈希(SHA-256)→ 存入数据库
  2. 包装端:将ID生成二维码贴于产品
  3. 用户端:扫码跳转验证页面(或扫描本地识别)
  4. 验证端:比对数据库记录 + 时间戳 + IP特征

防伪关键点:

七、Web集成:构建二维码生成服务

1. Flask快速生成服务

app.py
from flask import Flask, request, jsonify, send_file import qrcode from io import BytesIO app = Flask(__name__) @app.route('/generate', methods=['POST']) def generate_qr(): data = request.json.get('data', '') color = request.json.get('color', '#037ef3') if not data: return jsonify({"error": "缺少数据参数"}), 400 # 生成二维码 qr = qrcode.QRCode(version=1, error_correction=qrcode.ERROR_CORRECT_M) qr.add_data(data) qr.make(fit=True) img = qr.make_image(fill_color=color, back_color="white") # 转为字节流 buf = BytesIO() img.save(buf, format='PNG') buf.seek(0) return send_file(buf, mimetype='image/png') if __name__ == '__main__': app.run(host='0.0.0.0', port=5000)

调用示例(curl):

终端执行
curl -X POST http://localhost:5000/generate \ -H "Content-Type: application/json" \ -d '{"data":"https://www.xservx.com"}' \ --output qr.png

2. Vue前端集成示例

QRGenerator.vue

3. 部署到生产环境

推荐架构:

Dockerfile示例:

Dockerfile
FROM python:3.11-slim WORKDIR /app COPY requirements.txt . RUN pip install --no-cache-dir -r requirements.txt COPY . . EXPOSE 5000 CMD ["gunicorn", "-w", "4", "-b", "0.0.0.0:5000", "app:app"]

八、常见问题与调试技巧

1. 识别失败问题排查

现象可能原因解决方案
手机扫不出模块太小增大box_size(≥10)
部分识别边框不足border ≥ 4
内容错误编码错误检查URL编码(使用urllib.parse.quote)
嵌入Logo后失效遮挡关键区域提高纠错等级至H
动态二维码过期时间戳验证检查服务器时间同步

2. 调试工具推荐

3. 性能优化建议

九、高频FAQ

Q1:为什么生成的二维码扫描后内容不全?
A:数据超限导致截断。解决方案:增大version或压缩数据(如使用URL短链服务)。
Q2:如何让二维码在暗色背景上可见?
A:设置back_color为浅色(如#f0f0f0),fill_color为深色(如#000000),或使用反色处理(img = ImageOps.invert(img))。
Q3:生成的二维码能包含视频吗?
A:不能直接包含。但可生成指向视频URL的二维码,或使用MyQR生成带视频背景的动态二维码。
Q4:如何验证二维码是否符合ISO标准?
A:使用OpenCV检测定位点(finder patterns)和时序图案(timing patterns),或调用segno的validate()方法。
Q5:二维码能嵌入中文内容吗?
A:可以!Python默认使用UTF-8编码,直接传入中文字符串即可(如"你好世界")。

1. 二维码 vs 条形码

虽然都是信息载体,但关键差异如下:

2. 二维码安全风险

2024年黑帽大会披露的二维码攻击方式:

防御建议:

  1. 用户端:扫码前预览URL(微信/支付宝均支持长按查看链接)
  2. 生成端:启用HTTPS + 短链白名单
  3. 企业端:部署二维码内容过滤网关

3. 最新技术趋势

4. 免费生成器推荐

工具名称在线地址特色限制
QR Code Generatorhttps://www.qr-code-generator.com支持SVG导出免费版有水印
GoQRhttps://goqr.meAPI接口完善每日限100次
QR Stuffhttps://www.qrstuff.com支持WiFi/名片界面较旧
本站工具https://www.xservx.com/tools/qrcodePython原生生成,无广告需本地部署

5. 学习资源推荐