第一步：先搞懂二维码的”脾气”——不用数学也能明白的底层逻辑

很多人一听到”写源码”就打退堂鼓，觉得这得懂高深的数学知识，什么矩阵啊、加密算法啊，其实二维码没那么”高冷”。你可以把它想象成一个”数字化的快递盒”：盒子上有固定的”地址标签”（定位图案），里面的小格子装着”货物”（数据），还附了”备用清单”（纠错码），就算盒子有点破损，也能根据清单找回货物。我刚开始研究的时候，也被网上那些”版本号””掩码模式”的术语绕晕了，后来找了个可视化工具拆解了一个二维码，才发现它的结构其实很”规矩”。

二维码不是”随机涂鸦”——这些固定结构你必须知道

你拿出手机扫二维码时，有没有注意到三个角上都有一个”回”字形的方块？这叫定位图案，相当于二维码的”坐标锚点”，手机扫描时会先通过这三个点确定二维码的位置和方向，哪怕二维码有点倾斜也能识别。去年我第一次写代码生成二维码时，不小心把定位图案的尺寸调错了，结果生成的二维码怎么扫都没反应，后来才发现这三个”小眼睛”的尺寸是固定的，必须是7×7像素的方块，而且里面的黑色边框和白色内框比例也不能改。

除了定位图案，二维码中间还有一些”辅助线”——时序图案，就是那些间隔排列的黑白线，它们像坐标轴一样帮手机确定每个小格子的位置。你可以把二维码想象成一个棋盘，时序图案就是棋盘上的横线和竖线，没有它们，手机就分不清哪个格子是第3行第5列。 在二维码的右上角还有一个对齐图案，长得和定位图案有点像但小一些，它的作用是确保二维码在缩放或打印时有足够的清晰度，尤其是那些尺寸比较大的二维码（比如广告牌上的），没有对齐图案就很容易扫不出来。

这些固定结构占了二维码不少空间，剩下的格子才是真正存数据的地方。数据怎么存在格子里呢？其实特别简单：黑色格子代表”1″，白色格子代表”0″，就像我们用摩斯密码发消息，只不过这里用的是二进制。举个例子，你想在二维码里存”你好”这两个字，计算机会先把它转换成UTF-8编码的二进制数（大概是16个0和1），然后按照一定的顺序（从右下角开始，蛇形排列）填到数据区的格子里。如果数据太多格子不够怎么办？二维码有40个版本（版本1是21×21像素，版本40是177×177像素），版本越高格子越多，存的数据也就越多。

这里插一句，如果你想深入了解这些结构的具体规范，可以看看国家标准GB/T 18284-2000《快速响应矩阵码》（链接，nofollow），里面详细写了每个版本的尺寸、结构和编码规则，虽然有点枯燥，但看完你会对二维码有更清晰的认识。

第二步：选对工具等于成功一半——3款新手友好的开发”神器”

搞懂了二维码的基本结构，接下来就得选工具了。别一听”写源码”就觉得必须装Visual Studio或者PyCharm，其实对零基础来说，有很多”傻瓜式”工具能帮你快速上手。我去年帮朋友做二维码时，试过5种不同的工具，最后筛选出3款最适合新手的，各有各的优势，你可以根据自己的情况选。

不同工具怎么选？一张表帮你理清

下面这个表格是我根据自己的使用体验整理的，包含了工具名称、上手难度、功能亮点和适用场景，你可以对照着看看哪种更适合你：

工具名称	上手难度	功能亮点	适用场景
Python qrcode库	中等（需简单编程）	可自定义颜色、添加logo、调整纠错级别	想深入学习原理、需要批量生成二维码
草料二维码开放平台	低（纯网页操作）	提供API接口，支持在线调试，有详细文档	不想写代码，需要快速对接自己的小程序/网站
QR Code Generator（手机APP）	极低（纯图形界面）	实时预览效果，支持保存源码到本地	完全零基础，只想生成单个个性化二维码

我个人最推荐的是Python qrcode库，虽然需要写几行代码，但网上有很多现成的模板，改改参数就能用。去年我帮朋友批量生成会员二维码时，就是用这个库写了个循环脚本，100个会员二维码不到1分钟就生成完了，比在线工具一个个弄快多了。如果你完全没接触过编程，也别担心，现在Python有很多图形化编辑器（比如Mu Editor），界面和Word差不多，复制粘贴代码就能运行。

这里分享个小技巧：不管用什么工具，纠错级别一定要设对。二维码有4个纠错级别（L、M、Q、H），分别能恢复7%、15%、25%、30%的损坏数据。如果你想在二维码中间加logo，或者打印在容易磨损的地方（比如奶茶杯上）， 选H级，虽然会占用更多数据空间，但扫起来更稳定。我之前给朋友的奶茶店做二维码时，一开始选了M级，结果杯子上的二维码沾了点水渍就扫不出来了，后来改成H级，就算有点模糊也能识别。

第三步：从”跑通代码”到”自定义二维码”——实战案例手把手教

选好工具后，咱们就来动手实战。我以Python qrcode库为例，带你生成一个带个人名片信息的二维码，全程不超过20行代码，跟着做就能成。如果你用的是其他工具，思路也差不多，都是”输入内容→设置参数→生成二维码”这三步。

你需要在电脑上安装Python（官网下载就行，选3.8以上版本），然后打开命令提示符（Windows）或终端（Mac），输入pip install qrcode pillow安装必要的库——qrcode是生成二维码的核心库，pillow是处理图片的库，用来添加logo。安装的时候如果提示”pip不是内部命令”，别慌，这是因为Python没添加到系统环境变量，你可以百度”Python添加环境变量”，跟着教程操作，5分钟就能搞定。

接下来新建一个文本文件，把后缀名改成”.py”（比如”my_qrcode.py”），然后复制下面这段代码：

import qrcode
from PIL import Image
设置二维码内容（个人名片格式）
data = """BEGIN:VCARD
VERSION:3.0
FN:张三
TEL:13800138000
EMAIL:zhangsan@example.com
ADR:北京市海淀区
END:VCARD"""
创建二维码对象
qr = qrcode.QRCode(
 version=5, # 二维码版本（1-40），5对应45x45像素
 error_correction=qrcode.constants.ERROR_CORRECT_H, # 纠错级别H
 box_size=10, # 每个格子的像素大小
 border=4, # 边框宽度（最少4个格子）
)
添加数据并生成二维码
qr.add_data(data)
qr.make(fit=True)
img = qr.make_image(fill_color="darkblue", back_color="white") # 设置颜色
添加logo（可选）
logo = Image.open("logo.png") # 打开logo图片（确保和代码文件在同一个文件夹）
logo_size = (img.size[0] // 4, img.size[1] // 4) # logo大小设为二维码的1/4
logo = logo.resize(logo_size)
logo_pos = ((img.size[0] 
logo_size[0]) // 2, (img.size[1] 
logo_size[1]) // 2) # logo居中
img.paste(logo, logo_pos)
保存二维码
img.save("my_card.png")
print("二维码生成成功！")

这段代码的作用是生成一个包含个人名片信息的二维码，手机扫描后会自动识别为联系人信息，直接保存到通讯录。你需要把data里的内容改成自己的信息，比如姓名、电话、邮箱等；如果想添加logo，就准备一张名为”logo.png”的图片，和代码文件放在同一个文件夹里。我第一次运行这段代码时，因为logo图片太大，导致二维码中间的定位图案被挡住了，后来把logo尺寸改成二维码的1/4就好了——记住，logo面积最好不要超过二维码总面积的15%，否则会影响识别。

运行代码后，你会在文件夹里看到一个”my_card.png”的图片，用微信扫一扫就能看到效果了。如果想调整二维码的颜色，可以修改fill_color和back_color的参数，比如改成fill_color="#FF5252"（红色）、back_color="#F5F5F5"（浅灰色），但要注意前景色和背景色的对比度一定要高，否则手机可能扫不出来。我之前试过用浅粉色配浅黄色，结果10次有8次扫不出来，后来改成深紫色配白色，识别率立刻就上去了。

如果你用的是草料二维码开放平台，操作会更简单：打开官网后注册账号，找到”API接口”→”生成二维码”，在表单里输入内容、选择纠错级别、上传logo，点击”在线调试”就能生成二维码，还能直接复制源码到自己的网站里。我有个做公众号的朋友，就是用这个平台的API接口，在文章底部嵌入了动态二维码，读者扫码后会根据时间自动跳转不同的内容，特别方便。

按照这三步做完，你生成的第一个二维码可能还有点简单，但别急，多试几次调整参数，很快就能做出带渐变颜色、艺术边框的个性化二维码。比如我现在帮朋友做的奶茶店会员码，不仅加了店铺logo，还把数据区的格子改成了奶茶杯的形状，顾客都说比普通二维码好看多了。如果你成功了，欢迎在评论区晒出你的作品，或者说说你在制作过程中遇到的问题，咱们一起讨论解决！

---

你知道二维码的“版本”其实就像笔记本的不同尺寸吗？版本1就像巴掌大的便签本，版本40则是A4纸那么大的厚本子——尺寸不一样，能装的东西自然差很多。具体来说，版本1是21×21个小格子（每个格子算1像素），版本2是25×25个格子，每升一个版本，边长就多4个格子，一直到版本40，能达到177×177个格子，比最初的版本大了8倍多。我去年帮社区做活动二维码时，一开始随便选了版本3，结果想把活动时间、地点、报名链接都塞进去，生成的二维码挤得密密麻麻，手机扫半天没反应，后来才发现版本3只能存大概50个字符，换成版本10（57×57格子）才勉强够用，这才明白版本真不是随便选的。

选版本的关键其实看你要存多少东西。普通情况比如存个网址（像“https://example.com”这种）、手机号（11位数字），或者简单的文字（比如“扫码关注公众号”），选版本5-10就够了，对应的格子数是45×45到57×57，生成的二维码不大不小，手机扫起来也快。但如果要加logo，或者存的内容比较多——比如我之前帮朋友做的电子名片二维码，里面要放姓名、电话、邮箱、公司地址，还要塞一句“扫码添加好友”的备注，这种就得选版本15以上（77×77格子起），不然数据区太挤，很容易因为logo挡住部分格子导致扫码失败。另外提醒一句，版本不是越高越好，版本40虽然能存7000多个汉字，但生成的二维码太大，打印在名片上会模糊，日常用版本10-20其实最实用。

---

零基础完全没学过编程，真的能写出二维码源码吗？

完全可以。文章里提到的工具和方法都是为零基础设计的，比如草料二维码开放平台纯网页操作，不需要写代码；Python qrcode库虽然需要几行代码，但网上有大量现成模板，改改参数（如内容、颜色、logo）就能用。去年我帮奶茶店朋友做二维码时，他也是零基础，跟着教程1小时就生成了第一个可用的二维码，关键是理解“定位图案”“纠错级别”这些基础概念，不用懂复杂算法。

生成的二维码扫不出来，可能是什么原因？

常见问题有三个：一是定位图案错误，三个“回”字形方块必须是7×7像素，边框和内框比例不能改，改了手机就找不到“坐标”；二是纠错级别太低，比如内容多或要加logo时用了L级（仅恢复7%损坏），换成H级（恢复30%）会更稳定；三是logo太大或颜色对比度不够，logo面积 不超过二维码的15%，颜色避免浅粉配浅黄这类低对比组合，深紫配白色、深蓝配浅灰等对比明显的配色识别率更高。

用Python写二维码源码，需要安装哪些软件？

只需两步：先安装Python（官网下载3.8以上版本，Windows和Mac都有对应安装包），安装时记得勾选“Add Python to PATH”（添加环境变量），避免后续“pip不是内部命令”的问题；然后打开命令提示符（Windows）或终端（Mac），输入“pip install qrcode pillow”安装两个库——qrcode是生成二维码的核心工具，pillow用于处理图片（比如添加logo）。安装完成后，复制文章里的代码模板，改改个人信息就能运行。

二维码的“版本”是什么意思？该怎么选择？

版本是二维码的“尺寸规格”，从版本1到版本40，尺寸逐渐变大：版本1是21×21像素（每个小格子算1像素），版本2是25×25像素，以此类推，版本40达到177×177像素。版本越高，能存的数据越多（版本1约存20个汉字，版本40约存7000个汉字）。普通需求（如网址、手机号）选版本5-10即可（45×45到57×57像素），加logo或存大量内容（如长文本、多联系人信息） 选版本15以上，确保数据区有足够空间。

可以把二维码的颜色改成渐变色或图案吗？会影响识别吗？

可以改，但要注意“不遮挡关键结构+保证对比度”。渐变色 用深色到更深色的渐变（如深蓝到紫色），避免浅色渐变；图案可以加到数据区（中间非定位/时序图案的格子），但面积不能超过二维码总面积的15%，且不能覆盖三个定位图案、时序线和对齐图案。去年我帮朋友做奶茶店二维码时，用奶茶杯图案替换了部分数据区格子，只要保证黑色格子（代表“1”）的信息没被遮挡，手机依然能正常识别。