排错文章约 4 分钟
二维码扫不出来，先别急着怪工具。现实里大多数问题都很“基础”：内容太长、尺寸太小、对比不够、白边不够、Logo 压得太狠，或者贴的位置本来就不适合扫。
先检查这 6 个地方
1. 内容是不是太长了
内容越长，二维码越密。二维码一密，小尺寸打印、低像素截图、老手机镜头都会更容易失败。最常见的坑，是把一大段文本、复杂参数链接，或者堆了很多字段的联系人信息直接塞进去。
2. 打印尺寸是不是太小了
在屏幕上看起来“还能看清”，不代表手机就容易扫。尺寸一小，尤其再叠加远距离扫描、反光材质或者贴纸裁切，识别率会明显下降。
3. 颜色对比够不够
深灰配浅灰、品牌绿配米白、透明底压在照片上，这些都容易出问题。二维码优先保证“明暗对比”，不是优先保证“看起来高级”。
4. 四周白边有没有被吃掉
二维码四周的白边不是装饰，而是定位区。海报排版、贴纸裁切、截图裁边，经常会把这部分顺手切掉，结果手机连二维码边界都判断不清。
5. Logo 有没有放太大
Logo 本身不是不能放，但它会直接占用本来给识别用的区域。如果内容本来就密，再把中间挖掉一块，失败概率会很快上来。
6. 使用场景是不是本来就难扫
玻璃门、反光亚克力、弯曲包装、深色磨砂材质、远距离海报，这些都不是“普通难度”。同样一张二维码，换个材质和位置，识别体验可能完全不同。
最快的排错顺序
先把二维码恢复成最稳的样子：深色前景、浅色背景、保留白边、去掉大 Logo、适当加大尺寸。只要这样一改就能扫出来，问题通常就不是内容错误，而是设计或落地方式太激进。
不要只用一台手机测试
一台旗舰机能扫，不代表现场所有手机都能扫。上线前至少拿两三种不同手机测试一次，尤其是打印成品和真实安装位置，一定要实测。