python如何生成二维码 | python小知识

摘要：本文介绍了使用Python的qrcode库生成二维码的方法。主要内容包括：(1)二维码的基本原理与结构特点；(2)qrcode库的安装与基本使用方法；(3)二维码颜色定制、添加logo等高级功能；(4)WiFi连接和vCard联系信息等实际应用案例。qrcode库支持多种参数调整和输出格式，能生成满足不同需求的二维码。文章还提供了代码示例，帮助读者快速掌握二维码生成技术，并建议进一步探索动态

aiweker

696人浏览 · 2025-07-06 11:46:01

aiweker · 2025-07-06 11:46:01 发布

Python实现二维码生成：原理与qrcode库详解

1. 二维码简介与原理

二维码(QR Code)是一种矩阵式二维条码，由日本Denso Wave公司于1994年发明。QR是"Quick Response"的缩写，意为快速响应。

1.1 二维码的基本结构

二维码由以下部分组成：

位置探测图形：三个角落的正方形，用于定位二维码
对齐标记：帮助识别扭曲的二维码
时序模式：黑白交替的线条，用于确定数据矩阵密度
格式信息：存储纠错级别和掩码模式
数据和纠错码：实际存储的信息和用于纠错的冗余数据

1.2 二维码的优势

高容量：可存储多达7089个数字或4296个字母
高密度：相同面积比一维码存储更多信息
全方位可读：可从任何角度扫描
强纠错能力：即使部分损坏仍可读取

2. 安装qrcode库

在这里插入图片描述

Python的qrcode库是一个强大的二维码生成工具，安装非常简单：

pip install qrcode[pil]

[pil]选项会同时安装Pillow库，用于生成图片文件。

3. 基本用法

3.1 生成简单二维码

import qrcode

# 创建QRCode对象
qr = qrcode.QRCode(
    version=1,
    error_correction=qrcode.constants.ERROR_CORRECT_L,
    box_size=10,
    border=4,
)

# 添加数据
qr.add_data("https://www.example.com")
qr.make(fit=True)

# 生成图片
img = qr.make_image(fill_color="black", back_color="white")

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

代码解释：

version：二维码大小，范围1-40，数字越大尺寸越大
error_correction：纠错级别，有L(7%)、M(15%)、Q(25%)、H(30%)四种
box_size：每个小格子包含的像素数
border：边框包含的格子数
make(fit=True)：自动调整版本以适应数据

3.2 快速生成二维码

对于简单需求，可以使用快捷方法：

import qrcode

img = qrcode.make("Hello, World!")
img.save("quick_qr.png")

4. 高级功能

4.1 自定义颜色

qr = qrcode.QRCode()
qr.add_data("Colorful QR")
img = qr.make_image(fill_color="blue", back_color="yellow")
img.save("colorful_qr.png")

4.2 添加logo

from PIL import Image
import qrcode

# 生成基础二维码
qr = qrcode.QRCode()
qr.add_data("https://www.example.com")
img = qr.make_image(fill_color="black", back_color="white").convert('RGB')

# 添加logo
logo = Image.open("logo.png")
# 计算logo尺寸(不超过二维码的1/4)
logo_size = min(img.size) // 4
logo = logo.resize((logo_size, logo_size), Image.Resampling.LANCZOS)

# 计算logo位置
pos = ((img.size[0] - logo.size[0]) // 2, (img.size[1] - logo.size[1]) // 2)

# 粘贴logo
img.paste(logo, pos)
img.save("qr_with_logo.png")

4.3 生成SVG格式二维码

import qrcode
import qrcode.image.svg

# 方法1: 使用内置SVG工厂
factory = qrcode.image.svg.SvgImage
img = qrcode.make("SVG QR Code", image_factory=factory)
img.save("svg_qr.svg")

# 方法2: 使用片段工厂(更小文件)
factory = qrcode.image.svg.SvgFragmentImage
img = qrcode.make("SVG Fragment QR", image_factory=factory)
img.save("svg_fragment_qr.svg")

5. 实际应用示例

5.1 生成WiFi连接二维码

import qrcode

def generate_wifi_qr(ssid, password, security="WPA"):
    wifi_config = f"WIFI:T:{security};S:{ssid};P:{password};;"
    qr = qrcode.QRCode()
    qr.add_data(wifi_config)
    img = qr.make_image(fill_color="black", back_color="white")
    img.save(f"wifi_{ssid}.png")

generate_wifi_qr("MyWiFi", "securepassword123")

5.2 生成联系人信息二维码(vCard)

import qrcode

def generate_vcard_qr(name, phone, email, company=""):
    vcard = f"""BEGIN:VCARD
VERSION:3.0
FN:{name}
TEL:{phone}
EMAIL:{email}
ORG:{company}
END:VCARD"""
    qr = qrcode.QRCode()
    qr.add_data(vcard)
    img = qr.make_image()
    img.save(f"vcard_{name}.png")

generate_vcard_qr("张三", "13800138000", "zhangsan@example.com", "ABC公司")