二维码扫不出来怎么办？12 个常见原因和逐一修法

先测，别猜

动手改之前，先搞清楚这张码到底有多脆。一张在屏幕上看着没问题的码，印到菜单上、在昏暗灯光下就可能扫不动。把它丢进二维码猫的「可扫性测试」：它会先按原图解码，再分别用灰度、增强对比、缩到 1/3（模拟距离 / 小尺寸印刷）、缩到 80px（极小尺寸）各试一遍。能扛住的条件越少，说明这张码越接近失败边缘——下面的修法告诉你该拧哪个旋钮。

12 个最常见原因，逐一给修法

几乎所有扫不出的码都能归到下面某一条。从上往下排查，前几条占了绝大多数失败。

• 对比度太低。头号原因。扫描器靠明暗区分码点，深浅必须拉开。修：深色码点配白色或很浅的背景，别用浅配浅。
• 颜色反相（浅码点 + 深背景）。很多手机相机扫不动反相码，哪怕它「技术上」合法。修：让数据码点保持深色、背景保持浅色。
• 没留白边（静默区）。码四周需要约 4 个模块宽的空白。修：别裁得贴边，留出白边。
• 印得太小。经验公式：最小尺寸 ≈ 扫描距离 ÷ 10（50cm 处扫 → 码至少约 5cm）。修：印大一点，或缩短内容让码点变粗。
• 塞了太多内容。长网址、大 vCard 会让码版本变高、码点变细，一印就糊。修：缩短网址、精简名片信息，或印大一点。
• logo 太大 / 没居中。中心 logo 在高纠错下盖到约 25–30% 还行，再大就吃掉数据。修：缩小 logo，并用 H 级纠错。
• 渐变或花式形状用过头。装饰性的码点 / 眼睛形状没问题，危险的是渐变里最浅的那一档太淡。修：让渐变起色和终色都足够深。
• 印刷模糊 / 分辨率低。低清 PNG 拉到海报尺寸，码点全糊。修：凡是要印的，导出 SVG（矢量）。
• 反光或弧面。覆膜反光、瓶身杯壁会造成眩光或变形。修：用哑面、贴在更平的地方。
• 破损或被遮挡。折痕、订书钉、贴纸压在码上，破坏的模块超过纠错能恢复的范围。修：换位置、重印。
• 内容类型错了。WiFi、vCard 用错语法做出来，能扫但没用。修：用专门的 WiFi / 名片工具生成，别用纯文本框硬拼。
• 用了会过期的动态码。如果你用的免费站给的是短链跳转码，试用一到期码就死了。修：改用把内容直接编码进图案的静态码——它不会过期。

对比度和静默区，说人话

抓住两点就能修好大多数码。对比度：相机靠亮度区分码点，所以深的部分必须明显比浅的部分更深——黑配白最稳，深藏青配米白也行，灰配米色就不行。静默区：四周的空白告诉扫描器码从哪开始、到哪结束，裁掉它很多扫描器根本锁不住。在码四周留大约四个模块宽的白边，是你能买到的最便宜的可靠性。

要印刷，就导出 SVG

屏幕很宽容，印刷不是。矢量 SVG 放多大都清晰，码点会印成干净的方块，名片到广告牌都一样。低清 PNG 放大去印海报，是「屏幕上能扫、贴墙上扫不动」的经典原因。二维码猫每个生成器都免费导出 SVG——凡是要印的都用它。