深入理解二维码生成尺寸

详细了解二维码的原理，CSDN这两篇博客不错：

转自MachineChen的博客：http://blog.csdn.net/u012611878/article/details/53167009

转自琦小虾的博客：https://blog.csdn.net/ajianyingxiaoqinghan/article/details/78837864

我理解的二维码生成尺寸，验证了一下：

# 生成二位码
def create_qr_code(url, icon_file, file_name, save_path, ec='H'):
    ecn = 2
    if ec == "L":
        ecn = qrcode.ERROR_CORRECT_L
    if ec == 'M':
        ecn = qrcode.ERROR_CORRECT_M
    if ec == 'Q':
        ecn = qrcode.ERROR_CORRECT_Q
    if ec == 'H':
        ecn = qrcode.ERROR_CORRECT_H
    version = 6
    box_size = 5
    border = 1
    qr = qrcode.QRCode(
        version=version,
        # 设置容错率为最高
        error_correction=ecn,
        box_size=box_size,
        border=border,
    )
    qr_size = (21 + (version - 1) * 4 + border * 2) * box_size

二维码的尺寸与这几个参数有关：version ，border ，box_size，具体计算公式如下：

qr_size = (21 + (version - 1) * 4 + border * 2) * box_size

比如上面的代码：qr_size = (21 + (6 - 1) * 4 + 1* 2) * 5 = 215

但这个的计算公式是建立在一个参数的前提下：

qr.make(fit=True)

当然，我用的是qrcode

import qrcode

:param fit: If ``True`` (or if a size has not been provided), find the
            best fit for the data to avoid data overflow errors.

当fit为True时，会根据二维码填充的数据而自动匹配version，避免数据丢失。

当然，程序代码对这个地儿有判断的，当fit为False，填入数据大于版本规定数据时，会抛出DataOverflowError异常的：

Traceback (most recent call last):
  File "D:/thecover_project/cover_app_platform/app/test/test.py", line 118, in <module>124
    create_qr_code(content, icon_path, 'cs', save_path, 'H')
  File "D:/thecover_project/cover_app_platform/app/test/test.py", line 63, in create_qr_code
    qr.make(fit=False)
  File "C:\Users\DELL\PycharmProjects\cover_app_platform\venv\lib\site-packages\qrcode\main.py", line 95, in make
    self.makeImpl(False, self.best_mask_pattern())
  File "C:\Users\DELL\PycharmProjects\cover_app_platform\venv\lib\site-packages\qrcode\main.py", line 181, in best_mask_pattern
    self.makeImpl(True, i)
  File "C:\Users\DELL\PycharmProjects\cover_app_platform\venv\lib\site-packages\qrcode\main.py", line 122, in makeImpl
    self.data_cache = util.create_data(
  File "C:\Users\DELL\PycharmProjects\cover_app_platform\venv\lib\site-packages\qrcode\util.py", line 573, in create_data
    raise exceptions.DataOverflowError(
qrcode.exceptions.DataOverflowError: Code length overflow. Data size (1004) > size available (368)

程序计算长度是根据标准里的（Number of data bits）判断的，我们自己判断的话，可以用Data capacity 里的Byte来参考。

version范围为1到40，都有容错级别LMQH对应的允许填入数据长度对应的值，LMQH是啥呢：

 当若错级别设置为L时，二维码在模糊或残缺7%的情况下，还是可以扫描出结果的，H的话就是30%。

容错级别越高，肯定越好，但填充的数据就越少了，同时二维码的尺寸会变大。

ISOIEC 18004_2006Cor 1_2009（二维码ISO国际标准）：

 当version为9时，8位字节数L为230，M为180，Q为130，H为98，我这里是以Byte对应的标准来计算的。

也就是说，如果我的纠错级别为H，我的填充内容则不能超过98个8位字节，比如我要填充的跳转url为99个，则version会自动匹配10。

所以当你生成二维码时，fit一定要设置为True，这样就不用去计算你要填入的数据的长度来匹配version了。

还有一点，有人和我一样去翻qrcode源代码时，有点疑惑：

constants.py里维护的LMQH级别为什么是1,0,3,2，而不是0,1,2,3？最开始我也弄迷糊了，也为源代码错了，还打算修改这个地方，经过多次验证，发现是对的，

后来研究了一下文档，才发现，这里其实是二进制转换成的十进制，哈哈：

 纠错等级编码：

当你要填入的数据小于对应的允许值时，尺寸计算公式可以直接带入参数计算，当你的fit为True，填入数据又大于version对应的值时，会自动匹配计算尺寸，

这时二维码的大小就不是你之前期望的了。感兴趣的可以自己验证。

那一些生成二维码的网站上有选择尺寸的大小，是怎么实现的呢？比如联图网：https://www.liantu.com：

 

 其实只要事先确认要填充数据的值，再动态计算box_size就行：

content = "itms-se://?action=download-manifest&url=https://pkgXX.theXXver.cn/pkg/cover/plist/fm_cm_iOS/7.0.0/fm_cm_iOS1243.plist"
print(len(content))
icon_path = '/Users/drew/.jenkins/workspace/Android-xx/app/src/main/res/mipmap-xxhdpi/ic_collect_icon.png'
save_path = '/Users/Work/PycharmProjects/FM_Build_Packaging/resources/img/qrcode'
create_qr_code(content, icon_path, 'cs', save_path, 'H')

1.如上内容，计算出content长度为118（这里可以预估可能的最大长度），容错级别为H，version 10刚好满足，当然你可以设置更大一点的version，这样，fit就可以设置为False了。

 

 我要生成的大小为1500px，带入公式求出box_size():

version = 10
box_size = ？
border = 1
size = 1500

1500 = (21 + (10- 1) * 4 + 1* 2) * box_size， 算出box_size = 25.42。

则生成二维码时，box_size设置为25.42即可！但是box_size的取值是被int了的：

所以计算出来肯定是不会刚好合适的：

# version=12, border=1 对应的二维码尺寸与版本信息
# qr_size = {'6': 402, '9': 603, '12': 804, '15': 1005, '18': 1206, '23': 1541, '30': 2010, '38': 2546, '45': 3015}

上面是在version=12, border=1的情况下计算的二维码尺寸，那么我想生成1500尺寸的怎么办呢？

img = img.resize((1500, 1500), Image.ANTIALIAS)

用PIL的resize方法微调，把它拉升成需要的比例就行：按照公式计算的话，再被int一下，一般都会偏小，所以这里resize一般都会拉升，不会压缩，但生成的二维码，清晰度还是可以保障的，试了各种尺寸，都很清晰的。

以上，python 的 qrcode生成二维码的尺寸的个人拙见。

 附上二维码的版本与容量表：

 

 

 

 如有需要125页的二维码ISO国际标准pdf文档，可以留言发你。