"生成一个二维码"听起来是十秒钟的事，但实际工作中你可能遇到过：打印出来贴在产品上扫 5 次成功 1 次；加了 Logo 再也扫不出来；长 URL 转成"芝麻饼"。这些都和几个核心参数有关。
一、二维码到底是什么？
1994 年日本 Denso Wave 发明，由黑白模块组成的矩阵。三个角的"回字形"是定位标记，中间的小回字是对齐标记，其余是数据。
二、四个关键参数
1. 版本（Version）
40 个版本（V1-V40），版本越大矩阵越大。V1 是 21×21，V10 是 57×57，V40 是 177×177。版本越高对扫描器分辨率要求越高。
2. 纠错等级
| 等级 | 纠错率 | 适用场景 |
|---|---|---|
| L | ~7% | 清洁环境、电子屏 |
| M | ~15% | 一般通用，默认 |
| Q | ~25% | 工厂车间、户外 |
| H | ~30% | 带 Logo / 装饰 |
不是越高越好——纠错率 30% 的二维码可能比 7% 的复杂 50%。
3. 内容编码模式
- 纯数字：每 3 位 10 比特，最高效；
- 字母数字（仅大写+数字）：每 2 字符 11 比特；
- 8 位字节：每字符 8 比特；
- 汉字（GB2312）：每字 13 比特。
把 URL 小写改大写、避免 URL 编码、纯英文 URL 都能让二维码更小。
4. 模块尺寸与边距
静默区至少要等于 4 个模块的宽度。打印时每个模块至少 0.5mm（手机扫码 20cm 内），户外大型物料每个模块至少 5mm。
免费在线二维码生成工具
支持 URL/文本/Wi-Fi/vCard，本地生成
→
三、几种特殊用途二维码
Wi-Fi 二维码
WIFI:T:WPA;S:网络名;P:密码;H:false;;
vCard 名片
BEGIN:VCARD VERSION:3.0 FN:张三 TEL:+86-138-0000-0000 EMAIL:zhang@example.com END:VCARD
四、加 Logo 的正确姿势
- 纠错等级必须用 H；
- Logo 占的面积不要超过二维码 1/4；
- Logo 周围加白色背景边框；
- 必须用至少 3 款手机实测，每个角度试 5 次。
五、扫码失败排查
| 现象 | 解决 |
|---|---|
| 偶尔扫不出 | 提升纠错到 Q/H，加大尺寸 |
| 从来扫不出 | 四周留白等于 4 模块宽度；纯黑+纯白 |
| 某些手机不行 | 缩小 Logo；改用低饱和色 |
| 歪着扫不出 | 四角不能被覆盖 |
| 反光扫不出 | 用哑光纸打印 |
| 过远扫不出 | 每米距离 ≈ 每模块 1mm |
结语
二维码是连接物理世界和数字世界最广泛的桥梁。希望这篇文章能让你少一次"打印出来扫不出来"的窘境。