qrcode，一个超强的 Python 库！

大家好，我是涛哥，本文内容来自 涛哥聊Python ，转载请标原创。

今天为大家分享一个超强的 Python 库 - qrcode。

Github地址：https://github.com/lincolnloop/python-qrcode

---

QR码（Quick Response Code）广泛用于产品追踪、项目标识、时间记录等多种领域。Python的qrcode库提供了一个简单的接口来生成QR码，支持丰富的定制选项和高级数据编码功能。这使得它成为在现代应用程序中集成QR码的理想选择。

安装

安装Python qrcode库非常简单，可以通过Python的包管理器pip进行安装：

pip install qrcode[pil]

这条命令将安装qrcode库及其依赖，包括Pillow库，后者用于处理图像。

特性

• 易用性：提供了高级的API，简化了QR码的生成过程。
• 可定制性：支持多种定制选项，如大小、边界、颜色和错误校正级别。
• 集成图像处理：借助Pillow库，支持直接生成图像文件。
• 向量图形支持：可以生成SVG格式的QR码，适用于需要高质量打印的场合。

基本功能

生成简单的QR码

生成一个基本的QR码非常直接：

import qrcode

# 创建一个QR码生成器
qr = qrcode.QRCode(
    version=1,
    error_correction=qrcode.constants.ERROR_CORRECT_L,
    box_size=10,
    border=4,
)
# 添加数据
qr.add_data('Hello, QR!')
qr.make(fit=True)

# 创建一个图像并保存
img = qr.make_image(fill='black', back_color='white')
img.save('hello_qr.png')

这段代码创建了一个包含文本"Hello, QR!"的QR码，并将其保存为PNG格式的图像。

高级功能

qrcode库提供了多种高级功能，允许开发者更细致地控制QR码的生成过程，从而满足特定的需求和偏好。

生成带有图标的QR码

一个常见的高级用例是在QR码中间加入一个小图标，通常是一个logo，这可以增加品牌识别度，同时保持QR码的可扫描性。

import qrcode
from PIL import Image

# 创建一个带有中心图标的QR码
qr = qrcode.QRCode(
    error_correction=qrcode.constants.ERROR_CORRECT_H
)
qr.add_data('https://www.example.com')
qr.make()

# 生成QR码图像
img = qr.make_image(fill_color="black", back_color="white").convert('RGB')

# 加载logo图像并插入到QR码中心
logo = Image.open('logo.png')
logo.thumbnail((50, 50))
logo_pos = ((img.size[0] - logo.size[0]) // 2, (img.size[1] - logo.size[1]) // 2)
img.paste(logo, logo_pos)

# 保存生成的QR码
img.save('custom_qr.png')

这个示例展示了如何生成一个带有中心图标的QR码。通过在QR码中加入logo，提高了视觉吸引力同时保持了功能性。

生成多种格式的QR码

除了常见的图片格式，qrcode库还支持生成SVG格式的QR码，这对于需要在不同尺寸和分辨率下保持高质量的打印输出尤为重要。

import qrcode

# 生成SVG格式的QR码
qr = qrcode.QRCode(
    version=5,
    error_correction=qrcode.constants.ERROR_CORRECT_L,
    box_size=10,
    border=4,
)
qr.add_data('https://www.example.com')
qr.make(fit=True)

# 使用SVG工厂生成SVG图像
svg_img = qr.make_image(fill_color="black", back_color="white", image_factory=qrcode.image.svg.SvgImage)
with open("website_qr.svg", "wb") as f:
    svg_img.save(f)

这段代码生成了一个SVG格式的QR码，适用于需要在各种媒体上进行高质量打印的场合。

动态内容QR码

qrcode库可以用于生成动态内容的QR码，如实时更新的信息或临时的数据。

import qrcode
import datetime

# 生成包含当前日期时间的QR码
current_time = datetime.datetime.now().isoformat()
qr = qrcode.QRCode()
qr.add_data(f'Current time is: {current_time}')
img = qr.make_image(fill='black', back_color='white')
img.save('time_qr.png')

这个示例生成了一个包含当前日期和时间信息的QR码，适用于时间敏感的应用场合。

实际应用场景

qrcode库的灵活性和易用性使其适用于多种实际应用，从商业推广到信息共享，再到系统集成。

商业营销

在商业营销中，QR码常被用于提供快速访问网站链接、促销信息或联系方式。

import qrcode

# 生成包含促销网页链接的QR码
promo_url = "https://www.example.com/promotion"
qr = qrcode.QRCode(version=1, box_size=10, border=5)
qr.add_data(promo_url)
qr.make(fit=True)

promo_qr = qr.make_image(fill='black', back_color='white')
promo_qr.save('promo_qr.png')

这个示例生成了一个包含促销活动链接的QR码，顾客扫描后可以直接访问促销页面，增加了营销活动的参与度。

事件入场检票

QR码可以用于事件的入场管理，生成个性化的入场票。

import qrcode
from datetime import datetime

# 生成包含入场票信息的QR码
event_info = f"Event: Science Fair 2024; Date: {datetime.now().date()}; Entry: Gate 3"
ticket_qr = qrcode.make(event_info, error_correction=qrcode.constants.ERROR_CORRECT_H)
ticket_qr.save('event_ticket_qr.png')

这个示例生成了一个事件票务的QR码，包含了事件名称、日期和入场门号，使得事件管理更为高效。

WiFi网络共享

QR码可用于分享WiFi网络，无需手动输入复杂的密码。

import qrcode

# 生成WiFi访问信息的QR码
ssid = "ExampleNetwork"
password = "securepassword123"
wifi_info = f"WIFI:T:WPA;S:{ssid};P:{password};;"
wifi_qr = qrcode.make(wifi_info)
wifi_qr.save('wifi_qr.png')

这个示例生成了一个包含WiFi访问信息的QR码，用户扫描后可自动连接到指定的WiFi网络，提升了访问便利性。

个人名片

QR码可用于个人名片，快速分享联系信息。

import qrcode

# 生成包含个人联系信息的QR码
contact_info = "MECARD:N:John Doe;TEL:[phone];EMAIL:[e-mail];;"
contact_qr = qrcode.make(contact_info)
contact_qr.save('contact_qr.png')

这个示例创建了一个包含个人联系信息（名字、电话和电子邮件）的QR码，使得人们通过扫描就能快速保存联系方式。

总结

Python的qrcode库为生成QR码提供了一个高效且易于使用的解决方案，广泛应用于商业营销、事件管理、个人信息分享等多个领域。通过这个库，用户可以快速生成各种自定义QR码，包括嵌入网址、文本信息、WiFi连接详情等，极大地方便了信息的快速传递和获取。qrcode库支持多种错误校正级别，确保QR码的可靠性，即便在部分损毁的情况下仍可被扫描识别。此外，该库还支持生成多种格式的QR码，包括常见的图片格式和SVG格式，满足不同的打印和展示需求。简单的API和强大的功能使得qrcode库成为当前最受欢迎的Python QR码生成工具之一。