二维码扫不出来?按这 6 个顺序排查,基本一次就能定位
二维码扫不出来通常只有六种原因:内容太长、纠错等级太低、静区被裁、对比度不足、印得太小、Logo 盖住了关键模块。按这个顺序查,比反复换生成器有用。
第一步:确认是「扫不出」还是「扫出来不对」
扫出来是一串乱码或跳到了错误地址,说明二维码本身编码正确、只是内容写错了,跟清晰度无关——回去检查生成时输入的文本。真正的「扫不出」才是图像识别失败,下面五步才有意义。
还有一种情况是只有某一个 App 扫不出,微信能扫、支付宝不行。这通常指向内容格式而不是图像:微信对纯文本会当作「文本」处理并折叠,某些 App 遇到非 http 协议会直接拒绝。把内容改成完整的 https 链接再试。
第二步:静区(quiet zone)被裁掉了吗
静区是二维码四周那一圈空白边距,标准要求至少 4 个模块宽。它不是装饰,是解码器用来确认「这里有一个码」的边界信号。很多设计稿为了让二维码在版面上更紧凑,会把这圈白边裁到 1 个模块甚至贴边,结果就是相机找不到边界,怎么对都对不上。
这是最常见、也最容易忽略的一条。如果二维码是从别处裁切来的,或者被人手动贴到背景上,优先怀疑它。重新生成时把静区留足 4 个模块,或者至少别切掉白边。
第三步:对比度够不够
解码依赖黑白模块的灰度差。深色底 + 浅色码(反色)在标准里是允许的,但很多老式扫码引擎只认「深色模块、浅色背景」,遇到反色直接失败。品牌色二维码同理:浅黄色、浅灰色、渐变填充都可能掉到临界值以下。
经验阈值:模块颜色与背景色的相对亮度差要明显拉开,白底上的深色码最保险。如果一定要用品牌色,把前景调到足够深(比如深蓝 #1F3864 而不是天蓝 #6FA8DC),并且务必在真实手机上试扫,而不是只在屏幕上目测。
第四步:内容是不是太长了
二维码有版本上限:内容越多,需要的模块越多,单个模块在同样物理尺寸下就越小。一段 300 字的中文直接编码,会顶到版本 40、177×177 模块,印在名片上单个模块不到 0.1 毫米,手机根本分辨不出来。
解决办法不是把码印大,而是把内容变短:用短链替换长 URL、去掉跟踪参数(utm_* 那一串)、能用数字或字母就不要用中文。同样的内容换成短链,往往能从版本 10 降到版本 3,模块面积大三四倍,扫起来天差地别。
第五步:纠错等级和 Logo 的取舍
纠错等级 L / M / Q / H 分别能容忍约 7% / 15% / 25% / 30% 的模块损坏。等级越高越抗污损,但同样内容需要的模块也越多——这是一个必须权衡的交换,不是「越高越好」。
中间的 Logo 本质上就是一块「故意损坏」的区域。经验做法:Logo 面积不超过码面的 20% 时用 H;10% 以内用 Q;完全不放 Logo 就用 M,尺寸更小、更易扫。如果加了 Logo 之后扫不出,先把 Logo 缩小一圈,比换纠错等级更有效。
第六步:物理尺寸和材质
屏幕上的二维码扫码距离通常在 15–30 厘米,印刷品要看观看距离:名片约 2 厘米边长足够,海报贴在两米外就需要 8 厘米以上。粗略的经验是「扫码距离 ÷ 10」等于二维码的最小边长。
材质也会坏事:覆亮膜的印刷品在射灯下会反光,摄像头对不上焦;印在曲面(杯子、瓶身)上会变形;喷墨打印在高光纸上有墨水扩散,细模块会糊成一片。这些都不是生成器的问题,换生成器、调参数都没用。
常见问题
- 加了 Logo 就扫不出来,一定要降低纠错等级吗?
- 不一定,先缩 Logo。纠错能力是「能容忍多少模块损坏」的上限,而不是「盖住多少都行」的许可。Logo 盖住的位置如果正好切掉了定位图案或时序图案(右上、左下三个大方块和它们之间的虚线),纠错再高也救不回来——这种情况下必须把 Logo 往中间挪或缩小。
- 二维码最小能印多小?
- 取决于内容长度和扫描距离,没有单一数字。常见下限:内容为短链(版本 3 左右)时,印刷品边长 1.5–2 厘米、屏幕显示 120 像素以上就足够。如果边长已经到 1 厘米还要塞长 URL,先缩短内容,别再往下压尺寸。
- 打印出来的码能扫,贴到 PPT 里就扫不出?
- 多半是缩放插值导致的。把位图二维码拉大时,图片编辑器会用双线性或双三次插值,模块边缘被抹成渐变,解码器就分不清黑白了。正确做法是先生成足够大的位图(或直接用 SVG),再按需要的尺寸缩放,并且缩放倍数尽量取整数。