为什么我的二维码扫不出来 — 8 个常见错误

您生成了一个二维码。打印了。有人尝试扫描…什么都没发生。我们帮助用户调试了数千个这样的案例。这是 8 个最常见的原因，大致按频率排序。

1. 二维码太小

这是排名第 1 的原因。二维码需要足够的物理尺寸，让相机能够分辨每个独立模块。可靠的经验法则是 1:10 比例 — 二维码的边长至少应为扫描距离的十分之一。

• 从 30 cm 扫描（手中的手机）：至少打印 3 cm 宽
• 从 1 m 扫描（墙上海报）：至少 10 cm
• 从 5 m 扫描（广告牌）：至少 50 cm

如有疑问 — 做大一些。二维码太大不会有任何惩罚。

2. 深色和浅色模块之间对比度低

扫描器需要清楚区分深色方块和浅色背景。白底黑字是黄金标准。

规则：如果在相同颜色组合上不能舒适阅读黑色文字，二维码可能也不能可靠扫描。

3. 缺少 quiet zone（边框）

每个二维码都需要一个 quiet zone — 围绕它的浅色/空白像素边距，至少等于 4 个模块（其中「模块」是那些小方块之一）。没有它，扫描器无法知道代码在哪里结束。

4. 目标 URL 损坏

QR 扫描成功，手机打开浏览器，然后…404。二维码本身工作正常；问题出在内部的链接。

• 页面被重命名或移动
• 重定向链在某处中断
• bit.ly / 动态 QR 服务过期或被速率限制
• 站点要求登录而您的受众没有账户

这是支持静态二维码而非动态二维码的最强论据之一 — 故障点更少。

5. 打印质量问题

设计在屏幕上看起来清晰。印刷店输出模糊，墨水在模块之间渗透，或者整体有套准误差。常见解决方案：

1. 始终导出为 SVG（矢量，无限缩放）或 PNG（打印尺寸的 2 倍）
2. 对于非常小的二维码（小于 2 cm），使用 至少 600 DPI 的打印机
3. 避免在亮黑背景上打印 — 反射会迷惑相机
4. 曲面或变形表面（罐子、瓶子）需要比平面更大的二维码

6. 嵌入的 logo 太大

二维码中心的 logo 看起来很棒，但如果 logo 覆盖超过 ~25 % 的区域，代码将变得不可读。解决方案是提高纠错级别到 H（high），允许在代码失败之前最多 30 % 的数据被遮盖。

7. QR 在有问题的表面或角度上

二维码喜欢 平坦、哑光、光线充足 的表面：

• 反射表面 — 玻璃陈列柜、亮面层压板、有机玻璃后的屏幕
• 曲面 — 罐子、瓶子、马克杯（用更大尺寸补偿）
• 尖锐角度 — 45° 贴在墙上
• 阳光直射 — 使相机过度曝光
• 玻璃后 — 增加眩光和额外的反射层

8. 代码本身已损坏

这种情况罕见但真实存在。如果您复制了 QR 图像并被压缩（例如截图、再次截图、然后保存为 JPEG），模块可能会融合在一起。始终从工具生成的原始 SVG 或 PNG 开始工作。