直接调用 qrcode.make() 最快但仅支持 png 且不可定制;需改颜色、加 logo 或调尺寸,必须用 qrcode 类实例化后调 make_image();支付链接务必 url 编码并使用 https 协议;容错推荐 error_correct_m;保存前需确保路径合法且目录存在。

qrcode 库生成带链接的二维码,make() 和 make_image() 别混用
直接调 qrcode.make() 最快,但只能输出 PNG,没法改颜色、加 logo、调尺寸;真要定制就得用 QRCode 类实例化再调 make_image()。常见错误是以为 make() 返回的是可编辑的 QR 对象,其实它直接返回 PilImage,后续所有样式操作都会报错。
-
qrcode.make("https://pay.example.com?order=123")→ 一行出图,适合快速调试 - 要改模块颜色、边框宽度、格式(如 SVG)、嵌入 logo,必须走
QRCode()+add_data()+make_image() -
border参数默认是 4,单位是模块(module)数,不是像素;实际图片尺寸 = (版本对应模块数 + 2×border) × 缩放因子
微信/支付宝支付链接生成二维码,注意 URL 编码和协议头
支付链接里常带中文参数或特殊符号(如 商品名称=咖啡机&price=299.00),不编码会扫出来乱码甚至跳转失败。另外,微信要求必须是 https://,支付宝部分场景接受 alipay:// 协议,但网页端生成二维码仍建议统一用 https 跳转到 H5 支付页。
- 用
urllib.parse.quote()或quote_plus()处理参数值,别手动替换空格或中文 - 完整链接示例:
"https://pay.example.com/pay?order_id=abc123&name=" + quote_plus("夏日限定套餐") - 测试时先在浏览器里打开生成的链接,确认能正常跳转且参数没丢,再转成二维码
二维码容错等级选 ERROR_CORRECT_H 还是 ERROR_CORRECT_M
容错等级决定能被遮挡多少仍可识别。ERROR_CORRECT_H 最高(30% 模块损坏仍可读),但二维码看起来更“密”、更糊,打印小尺寸时容易扫不出;日常支付链接用 ERROR_CORRECT_M(15%)足够,兼顾清晰度和鲁棒性。
-
QRCode(error_correction=qrcode.constants.ERROR_CORRECT_M)是推荐起点 - 要加 logo 且 logo 占比超 15%,才考虑升到
ERROR_CORRECT_Q或H - 别盲目设
H:实测在 200×200px 图片里,H级生成的二维码手机扫码成功率反而低于M级
保存二维码文件时,save() 的路径和格式别写错
常见崩溃点:路径含中文没处理、扩展名和实际格式不一致、目录不存在。PIL 的 save() 不会自动创建父目录,也不会根据文件名后缀智能选格式——它只认你传进去的 format 参数或后缀推断结果。
- 路径含中文?用
os.path.join()拼接,并确保 Python 文件本身用 UTF-8 编码保存 - 写
qr_img.save("qrcode.png")没问题;但写qr_img.save("qrcode.jpg", format="PNG")会报错 - 务必先
os.makedirs(os.path.dirname(path), exist_ok=True),尤其生成路径是./output/qrcode/xxx.png这种多级目录时
Python免费学习笔记(深入):立即使用
在学习笔记中,你将探索 Python 的核心概念和高级技巧!











