详解 Python qrcode 二维码模块

♚

作者：以茄至名，zhihu.com/people/iCheez

项目地址

1. https://github.com/lincolnloop/python-qrcode

声明

1. import qrcode

使用

QRCode 方法

1. qrcode.QRCode(

2.    version=1,

3.    error_correction=qrcode.ERROR_CORRECT_L,

4.    box_size=10,

5.    border=4,

6.    image_factory=None,

7.    mask_pattern=None)

参数解释

1、version：控制二维码的大小，取值范围从1到40。取最小值1时，二维码大小为21*21。取值为 None （默认）或者使用fit=true参数（默认）时，二维码会自动调整大小。

2、error_correction：控制二维码纠错级别。

• ERRORCORRECTL：大约7%或者更少的错误会被更正。

• ERRORCORRECTM：默认值，大约15%或者更少的错误会被更正。

• ERRORCORRECTQ：大约25%或者更少的错误会被更正。

• ERRORCORRECTH：大约30%或者更少的错误会被更正。

3、box_size：控制二维码中每个格子的像素数，默认为 10。

4、border：控制二维码四周留白包含的格子数，默认为4。

5、image_factory：选择生成图片的形式，默认为 PIL 图像。

6、mask_pattern：选择生成图片的的掩模。

方法属性解释

常用方法：

1、add_data(str,optimize=20):添加要转换的文字到data参数；如果使用了optimize优化参数，数据将被拆分为多个块来进行优化，以找到一个长度至少为这个值的足够简洁的方式来生成二维码。设置为“0”以避免优化。

2、make(fit=True):当fit参数为真或者没有给出version参数时，将会调用bestfit方法来找到适合数据的最小尺寸。如果没有设置maskpattern，将会调用bestmaskpattern方法来找到找到最有效的掩模图案。最后将这些数据传递给makeImpl方法来生成二维码。与qrcode本体的make方法不一样的是，这个方法没有任何返回值。

3、makeimage(fillcolor=None, backcolor=None,imagefactory=None):创建二维码的图像并返回，默认为 PIL 图像。如果要让二维码有颜色，可以在这里设置。

4、clear:清空数据

5、get_matrix:返回二维码数组。

6、print_ascii(out=None, tty=False, invert=False):这个方法就比较有趣了，可以用字符画的形式来输出二维码，但是扫的时候一般都扫不出来。

其中的invert参数是决定是否反转颜色的参数，默认为假，如果为真的话会这样：

其他方法：

1、bestfit(start=self.version):找到适合数据所需的最小尺寸。 

2、bestmaskpattern():找到最有效的掩模图案。 

3、makeImpl(test, maskpattern):生成二维码的直接函数 

4、mapdata:（内部函数，无需了解） 

5、printtty(out=None):用TTY颜色输出二维码，如果没有给出out参数，会使用sys.stdout。

6、setuppositionadjustpattern:（内部函数） 

7、setuppositionprobepattern:（内部函数） 

8、setuptimingpattern:（内部函数） 

9、setuptypeinfo:（内部函数） 

10、setuptypenumber:（内部函数）

属性：

1、border: 

2、boxsize: 

3、datacache: 

4、datalist: 

5、errorcorrection: 

6、imagefactory: 

7、maskpattern: 

8、modules: 

9、modules_count: 

10、version:

生成 SVG 图像

qrcode可以生成三种不同的svg图像，一种是用路径表示的svg，一种是用矩形集合表示的完整svg文件，还有一种是用矩形集合表示的svg片段。第一种用路径表示的svg其实就是矢量图，可以在图像放大的时候可以保持图片质量，而另外两种可能会在格子之间出现空隙。

这三种分别对应了svg.py中的SvgPathImage、SvgImage和SvgFragmentImage类。在调用qrcode.make函数或者实例化QRCode时当作image_factory参数的值传入就可以了。

1. import qrcode.image.svg

2. if method == 'basic':    # Simple factory, just a set of rects.

3.    factory = qrcode.image.svg.SvgImage

4. elif method == 'fragment':    # Fragment factory (also just a set of rects)

5.    factory = qrcode.image.svg.SvgFragmentImage

6. else:

7.    # Combined path factory, fixes white space that may occur when zooming

8.    factory = qrcode.image.svg.SvgPathImage

10. img = qrcode.make('Some data here', image_factory=factory)

生成 PNG 图像

执行命令安装pymaging相关模块：

1. pip install git+git://github.com/ojii/pymaging.git#egg=pymaging

2. pip install git+git://github.com/ojii/pymaging-png.git#egg=pymaging-png

然后给image_factor参数传入qrcode.image.pure.PymagingImage就可以生成PNG图片了。

1. import qrcode from qrcode.image.pure

2. import PymagingImage

3. img = qrcode.make('Some data here', image_factory=PymagingImage)

这是作者推荐的方式，但是我个人认为，完全没有必要这么麻烦，直接用默认的 PIL 就可以获取 PNG 图片了，例子看下文。

make 方法

make方法实际上就是在内部调用了QRCode(要转换的文本).make_image()，最后（默认）返回了一个PIL图像对象。

1. # 显示图片qrcode.make("hello world!").show()

2. # 保存 PNG 图片qrcode.make("hello world!").save('hello.png')

run_example 方法

生成一个作者项目网站地址的二维码并显示出来。

Python中文社区作为一个去中心化的全球技术社区，以成为全球20万Python中文开发者的精神部落为愿景，目前覆盖各大主流媒体和协作平台，与阿里、腾讯、百度、微软、亚马逊、开源中国、CSDN等业界知名公司和技术社区建立了广泛的联系，拥有来自十多个国家和地区数万名登记会员，会员来自以公安部、工信部、清华大学、北京大学、北京邮电大学、中国人民银行、中科院、中金、华为、BAT、谷歌、微软等为代表的政府机关、科研单位、金融机构以及海内外知名公司，全平台近20万开发者关注。

▼ 点击下方阅读原文，免费成为社区会员