Python生成二维码教程：qrcode库安装与使用

生成二维码的方法很简单，使用Python的qrcode库即可实现。首先需安装qrcode库，命令为pip install qrcode；若需图片或彩色支持，则安装qrcode[pil]。基础方法是通过几行代码创建并保存二维码文件，如指向网址或文本内容。进一步可自定义样式，包括版本号、容错率、边框宽度、颜色等参数，使二维码更美观或嵌入Logo。最后需要注意内容长度、尺寸、识别效果及叠加元素的比例，以确保二维码可正常扫描。

生成二维码其实不难，用Python的qrcode库就能轻松实现。你只需要几行代码，就能把文字、网址甚至联系方式变成可扫描的二维码。

安装 qrcode 库

要使用这个功能，首先得安装 qrcode 这个第三方库。打开命令行工具（比如终端或cmd），输入下面这行命令：

pip install qrcode

如果你还想生成带图片或彩色的二维码，可以额外安装 qrcode[pil] 版本，它会自动带上 PIL 库的支持：

pip install qrcode[pil]

最基础的二维码生成方法

装好之后，就可以开始写代码了。下面是最简单的一个例子，用来生成一个包含文本内容的二维码：

import qrcode

# 创建二维码对象
qr = qrcode.make('https://www.example.com')

# 保存为图片文件
qr.save('my_qr.png')

这段代码会生成一个指向 example.com 的二维码图片，名字叫 my_qr.png。你可以用手机扫码试试看能不能跳转过去。

如果你想控制更多细节，比如二维码的尺寸、容错率、边框大小等，可以用更详细的参数配置。

自定义二维码样式和内容

有时候你想让二维码更好看，或者嵌入 logo，这时候就需要用到更多的设置项了。下面是几个常用选项：

• 版本号：决定二维码的大小，从1到40，数字越大二维码越复杂。
• 容错率：推荐用 qrcode.constants.ERROR_CORRECT_H，即使二维码被部分遮挡也能扫出来。
• 边框宽度：默认是4，数值越小二维码图案越靠近边缘。
• 颜色和背景色：需要配合 PIL 使用，才能设置成彩色。

举个例子：

qr = qrcode.QRCode(
    version=3,
    error_correction=qrcode.constants.ERROR_CORRECT_H,
    box_size=10,
    border=4,
)

qr.add_data("Hello, world!")

img = qr.make_image(fill_color="blue", back_color="yellow")
img.save("colorful_qr.png")

这样你会得到一个蓝色的二维码，背景是黄色的，比默认的好看多了。

如果想加 logo 或者改成圆形图标，那就要用到 PIL 对图像的裁剪和叠加操作了，这部分稍微复杂一点，但网上也有很多现成的例子可以参考。

常见问题和注意事项

生成二维码虽然简单，但有些地方容易出错或忽略：

• 确保内容不要太长，否则二维码复杂度会上升，影响识别效果。
• 如果用了彩色或图片，记得测试一下是否还能正常识别。
• 不建议把二维码做得太小，特别是打印使用时，尽量保证清晰度。
• 图片叠加的位置最好在中间，大小不要超过二维码整体的 20%。

基本上就这些。整个过程不复杂，但细节上还是要注意一下，不然可能会扫不出来。只要按照上面的方法来，一般都能顺利生成可用的二维码。