企业官网建设流程全解析

如何用 Python 快速生成 3 种惊艳二维码？amazing-qr 动态二维码生成器完整入门指南

【免费下载链接】amazing-qr💮 amazing QRCode generator (supporting animated gif) - amazing 二维码生成器（支持 gif 动态图片二维码）项目地址: https://gitcode.com/gh_mirrors/am/amazing-qr

amazing-qr（amzqr）是一个用 Python 快速生成二维码的开源工具，一条命令就能做出普通二维码、带图片的艺术二维码，以及会动的动态 GIF 二维码。它跨平台、依赖极少（仅 Pillow），新手也能 3 分钟上手。本文将带你完整入门 amazing-qr 动态二维码生成器，从安装到生成 3 种惊艳效果。

为什么选择 amazing-qr？

相比普通只能输出黑白的生成器，amazing-qr 的核心亮点在于「把二维码变成艺术品」：

• 📦纯 Python + Pillow：pip一行安装，无需编译。
• 🎨三种形态：普通、艺术（黑白/彩色）、动态 GIF，一次覆盖大多数场景。
• 🖼️融合图片：把任意图片「藏」进二维码数据区，支持对比度、亮度调节。
• 🔄会动的二维码：输入.gif即输出逐帧动画二维码。

下面这三张彩色艺术二维码，就是 amazing-qr 的真实效果：

一键安装 amzqr

先安装命令行与 Python 库（二选一，推荐都装）：

pip install amzqr

如果你想从源码运行或参与开发，也可以克隆仓库后使用根目录脚本 amzqr.py：

git clone https://gitcode.com/gh_mirrors/am/amazing-qr

安装后，amzqr命令即可全局使用；未安装时可用python amzqr.py代替。版本声明见 pyproject.toml，CLI 入口实现在 amzqr/terminal.py。

快速生成 3 种惊艳二维码

1️⃣ 普通二维码：最基础的入口

只给一个链接或一句话，就生成一张标准黑白二维码：

amzqr https://example.com

默认输出为当前目录下的qrcode.png。用-v控制边长（1~40，越大越长），用-l控制纠错等级（L/M/Q/H，默认最高级H）：

amzqr https://example.com -v 10 -l Q -n my_qr.png

2️⃣ 艺术二维码：把图片「藏」进二维码

加上-p 图片文件就能让二维码与一张图片融合，默认输出黑白艺术码；再加-c变为彩色：

# 黑白艺术码 amzqr https://example.com -p cat.jpg # 彩色艺术码，并微调对比度与亮度 amzqr https://example.com -p cat.jpg -c -con 1.5 -bri 1.2

• -p：指定要融合的图片（支持.jpg/.jpeg/.png/.bmp/.gif）。
• -c：启用彩色输出。
• -con/-bri：调节对比度、亮度，1.0为原图，越大越强。

效果如下——二维码数据区被图片自然填充，中心图标清晰可读，扫码依旧灵敏：

3️⃣ 动态 GIF 二维码：会动的二维码 ✨

动态码与艺术码用法几乎相同，唯一区别是输入一张.gif动图，工具会把每一帧都合成进二维码，再打包成.gif输出：

amzqr https://example.com -p moving_cat.gif # 自定义文件名时，扩展名必须保持 .gif amzqr https://example.com -p moving_cat.gif -n my_animated_qr.gif

提示：.gif逐帧处理较多，耗时稍长，请耐心等待即可。合成逻辑见 amzqr/amzqr.py。

命令行参数速查

用 Python 库调用

在程序里集成，只需导入run，参数与命令行一一对应，返回version, level, 输出路径：

from amzqr import amzqr import os version, level, qr_path = amzqr.run( "https://example.com", version=1, level="H", picture="cat.jpg", # 传 .gif 即生成动态码 colorized=True, # 彩色 contrast=1.0, brightness=1.0, save_name="art_qr.png", save_dir=os.getcwd(), ) print("生成成功:", qr_path)

使用小贴士（新手必看）

• 📐 请尽量使用正方形或近似正方形的图片，融合效果更自然。
• 📏 图片越大时，建议把-v也适当调大，避免像素感过强。
• 🎯 透明区域最终会呈现为白色，需要纯色效果可先在图片工具里填白。
• 🔤 支持数字、大小写字母及常见英文标点与空格；超长内容会自动匹配更高版本。

项目结构一览

amazing-qr 采用清晰的分层设计，核心生成流程位于 amzqr/mylibs/theqrmodule.py，按「数据编码 → 纠错编码 → 结构化 → 矩阵 → 绘图」逐步完成：

• amzqr/amzqr.py：对外run()与图片合成combine()。
• amzqr/terminal.py：命令行入口与参数解析。
• amzqr/mylibs/data.py、amzqr/mylibs/ECC.py：数据与纠错编码。
• amzqr/mylibs/matrix.py、amzqr/mylibs/draw.py：矩阵生成与绘图。
• amzqr/mylibs/constant.py：布局常量（每模块像素、定位区等）。
• README-cn.md：官方中文文档与全部示例。

小结

amazing-qr 动态二维码生成器用一条命令 + 三个关键参数，就帮你从「普通二维码」进阶到「艺术码」和「会动的 GIF 码」。记住这三步即可：

1. pip install amzqr一键安装；
2. amzqr 链接生成普通码；
3. 加-p（配合-c）做艺术码，输入.gif做动态码。

快去试试吧，把二维码从「工具」变成「作品」！🎉

【免费下载链接】amazing-qr💮 amazing QRCode generator (supporting animated gif) - amazing 二维码生成器（支持 gif 动态图片二维码）项目地址: https://gitcode.com/gh_mirrors/am/amazing-qr