Python使用MyQR库生成动态二维码完整指南

向北走

发布时间：2026-10-10| 1人浏览过

原创

本文详细介绍如何使用Python的MyQR库快速生成静态与动态二维码。从环境安装、基础代码编写到背景图适配、色彩对比度调节及批量自动化脚本，提供完整的操作参数与避坑指南，帮助开发者高效实现创意二维码定制。

目标与环境准备

通过MyQR开源库，可以使用极简代码将URL或文本数据转换为内嵌静态或动态（GIF）背景图的二维码。操作前需确保Python运行环境已就绪，并执行以下安装命令：

pip install MyQR
# 或使用uv环境管理工具
uv add MyQR

核心操作与代码实现

第一步：生成基础静态二维码

默认调用可直接写入网址或文本。系统会自动提取背景主色并生成黑白二维码。为避免格式报错，建议对输出文件后缀进行严格校验。

from MyQR import myqr

def get_simple_qrcode(words, save_name):
    ext = save_name.split('.')[-1]
    if ext.lower() in ["jpg", "png"]:
        myqr.run(
            words=words,          # 目标链接或文本
            save_name=save_name   # 输出文件名
        )
        print(f"已生成简单二维码，存储至{save_name}")
    else:
        raise AttributeError(f"不支持的保存格式：.{ext}，请使用jpg或png")

get_simple_qrcode("https://github.com", "basic_qr.png")

第二步：生成带动画效果的彩色二维码

引入背景图（支持GIF动图）并开启colorized=True即可生成彩色动态码。version参数设定数据结构容量（范围1~40），数值越高抗遮挡能力越强，但生成的二维码整体尺寸也会相应放大。

myqr.run(
    words='Hello World!',
    picture='input.gif',      # 动态背景源文件
    colorized=True,           # 启用彩色混合模式
    save_name='animated_qr.gif',
    version=6                 # 二维码复杂度等级
)

第三步：自定义对比度与亮度参数

当背景图颜色过深或纹理复杂时，需手动调节contrast（对比度，默认1.0，范围0~2）与brightness（亮度，默认1.0，范围0~2）以保证扫码识别率。参数调整后建议先截取单帧查看前景黑块与背景的分离程度。

myqr.run(
    words='COLOR DEMO',
    picture='bg.jpg',
    colorized=True,
    contrast=1.2,             # 增强模块边界识别
    brightness=0.8,           # 适当压暗背景提升前景反差
    save_name='tuned_qr.gif'
)

高级处理与批量生成

第四步：调整GIF帧速与图像预处理

若需控制动态二维码的播放速度，可借助Pillow直接修改帧间隔时长（单位毫秒）。对于复杂的底图，建议先用OpenCV进行亮暗度预览，确认参数稳定后再投入正式生成。

pip install pillow opencv-python

# 调整GIF播放速率
from PIL import Image
with Image.open('input.gif') as img:
    img.save('adjusted.gif', 
             save_all=True, 
             duration=100,   # 每帧停留时间(ms)，数值越小速度越快
             loop=0)

# OpenCV亮暗度预览
import cv2
img = cv2.imread('input.jpg')
preview = cv2.convertScaleAbs(img, alpha=1.2, beta=50)
cv2.imshow("Preview", preview)
cv2.waitKey(0)

第五步：目录扫描与批量输出脚本

结合os.walk可实现指定目录下所有背景图的批量映射生成。脚本中加入了严格的路径拼接与后缀过滤，防止因非法文件格式导致程序异常终止。

from MyQR import myqr
import os

def generate_batch(url, logo_dir, out_dir, colorized=True, ver=6):
    if not os.path.isdir(out_dir):
        os.makedirs(out_dir)
        
    for root, _, files in os.walk(logo_dir):
        for file in files:
            ext = file.rsplit('.', 1)[-1].lower()
            if ext not in ('jpg', 'jpeg', 'png', 'gif'):
                continue
                
            bg_path = os.path.join(root, file)
            save_file = f"{out_dir}/qrcode_{file}"
            
            myqr.run(
                words=url,
                picture=bg_path,
                colorized=colorized,
                version=ver,
                save_name=save_file
            )
            print(f"完成生成: {save_file}")

if __name__ == '__main__':
    generate_batch("https://example.com", "./logos", "./output_qrs")