Python二维码生成库qrcode安装和使用示例

二维码简称 QR Code（Quick Response Code），学名为快速响应矩阵码，是二维条码的一种，由日本的 Denso Wave 公司于 1994 年发明。现随着智能手机的普及，已广泛应用于平常生活中，例如商品信息查询、社交好友互动、网络地址访问等等。

安装 Python 的二维码库 -- qrcode

由于生成 qrcode 图片需要依赖 Python 的图像库，所以需要先安装 Python 图像库 PIL(Python Imaging Library)，不然会遇到 "ImportError: No module named Image" 的错误：

sudo easy_install pil

如果安装 pil 时出现以下错误：

_imagingft.c:73:10: fatal error: 'freetype/fterrors.h' file not found

#include <freetype/fterrors.h>

         ^

1 error generated.

error: Setup script exited with error: command 'cc' failed with exit status 1

在 StackOverflow 上发现是 Mac 下所依赖的 FreeType 链接变更问题，解决如下：

ln -s /usr/local/include/freetype2 /usr/local/include/freetype

sudo easy_install -U pil

安装 qrcode 库：

sudo easy_install qrcode

成功安装后，即可以在终端里使用 qr 命令生成二维码了：

qr "Just a test" > test.png

qr --help

示例代码

import qrcode

 

 

qr = qrcode.QRCode(

    version=2,

    error_correction=qrcode.constants.ERROR_CORRECT_L,

    box_size=10,

    border=1

)

qr.add_data("http://3water.com/")

qr.make(fit=True)

img = qr.make_image()

img.save("dhqme_qrcode.png")

参数 version 表示生成二维码的尺寸大小，取值范围是 1 至 40，最小尺寸 1 会生成 21 * 21 的二维码，version 每增加 1，生成的二维码就会添加 4 尺寸，例如 version 是 2，则生成 25 * 25 的二维码。

参数 error_correction 指定二维码的容错系数，分别有以下4个系数：

1.ERROR_CORRECT_L: 7%的字码可被容错
2.ERROR_CORRECT_M: 15%的字码可被容错
3.ERROR_CORRECT_Q: 25%的字码可被容错
4.ERROR_CORRECT_H: 30%的字码可被容错

参数 box_size 表示二维码里每个格子的像素大小。

参数 border 表示边框的格子厚度是多少（默认是4）。

运行上面代码会生成敝站的一个 QR Code：

生成带有图标的二维码

二维码的容错系数（上面所指的 error_correction）越高，生成的二维码则可允许的残缺率越大，且二维码的数据主要保存在图片的四个角上，所以在二维码中间放一个小图标，对二维码的识别也是不受多大影响的。

对于插入在二维码上的图标大小，这里指定限制图标的大小尺寸最大是二维码长宽的 1/4，以免残缺太大，影响识别。

最后结合 Python 图像库（PIL）的操作，把图片黏贴（paste）在二维码图片的中间，便可以生成一个带有图标的二维码，具体操作代码如下：

import Image

import qrcode

 

 

qr = qrcode.QRCode(

    version=2,

    error_correction=qrcode.constants.ERROR_CORRECT_H,

    box_size=10,

    border=1

)

qr.add_data("http://3water.com/")

qr.make(fit=True)

 

img = qr.make_image()

img = img.convert("RGBA")

 

icon = Image.open("favicon.png")

 

img_w, img_h = img.size

factor = 4

size_w = int(img_w / factor)

size_h = int(img_h / factor)

 

icon_w, icon_h = icon.size

if icon_w > size_w:

    icon_w = size_w

if icon_h > size_h:

    icon_h = size_h

icon = icon.resize((icon_w, icon_h), Image.ANTIALIAS)

 

w = int((img_w - icon_w) / 2)

h = int((img_h - icon_h) / 2)

img.paste(icon, (w, h), icon)

 

img.save("dhqme_qrcode.png")

PS：本站还提供了一个功能非常强大的二维码生成工具，感兴趣的朋友可以参考一下：