二维码（QR code）扫不出来时，原因几乎总是以下十二种之一：颜色、尺寸、打印或显示方式、背后的链接，或者使用相机的方法出了问题。按下面的清单逐项排查，通常一两分钟就能找到元凶。无论你是举着手机扫码的人，还是制作二维码的人，每个原因都配有具体的解决办法。
颜色与对比度问题
对比度不足。 扫码软件识别的是深色块与浅色块之间的差异，所以浅灰配白色、黄色配米色，或者任何粉彩配粉彩的搭配，即使肉眼看着很清楚，也可能扫不出来。解决办法很简单：让深色模块真正深，背景真正浅。黑白配是最可靠的组合，所有扫码软件都是按它调校的。如果想用品牌色，就让模块保持深色、背景接近白色，并且在打印任何东西之前，至少用两部不同的手机测试一遍。
颜色反转。 深色背景配浅色块——比如藏青底上的白色码——正好是相反的情形。有些相机应用能处理，有些不行，而商店和仓库里的专用扫码枪最不宽容。解决办法：把配色翻转过来，让深色模块落在浅色背景上。如果设计上必须用深色底板，就在二维码后面垫一个白色圆角方块，而不是把二维码本身反色。
尺寸与密度问题
二维码太小。 一个通用的经验法则是：二维码的宽度至少应达到扫码距离的十分之一。名片上的二维码，按约30厘米的扫码距离算，宽度至少要3厘米；海报从3米外观看，二维码就要做到30厘米左右。如果你的码低于这个标准，请重新生成一个更大的，而不是把现有图片拉伸放大，然后重新打印。
数据太多导致图案过密。 二维码是一个由小方块组成的网格，数据每多一个字符，方块就多一批。60个字符的网址生成的网格明显比15个字符的细密，而包含十几个字段的完整名片（vCard）还要更密。细密的网格最先在廉价打印机、低分辨率屏幕和远距离拍摄时出问题。解决办法：减少码里的内容。缩短网址，把vCard精简到别人真正需要的字段，或者改用只存一条短跳转链接的动态码。像QRCodeMax.Vip这样的免费生成器会让你清楚地看到：数据越短，图案越简单——方块更大更少，扫码成功率也高得多。
留白区与Logo问题
缺少留白区。 留白区是二维码四周的空白边距，QR规范要求四周各留四个模块宽——也就是一个小方块宽度的四倍。设计师常常把它裁掉，或者让文字、图形紧贴码的边缘，扫码软件便无法判断二维码从哪里开始。解决办法：四周至少保留四个模块宽的空白，边框也绝不能紧贴最外圈的方块。
Logo过大。 在码里嵌入Logo意味着遮住一部分数据模块，靠纠错机制补全缺口。Logo一旦过大，二维码就无法解码了。经验法则是：Logo不要超过二维码宽度的四分之一，生成时把纠错等级设为高，并且先测试打印出来的实物——不能只看屏幕预览——再批量印刷。
打印与表面问题
反光或曲面。 亮光覆膜、相框玻璃、亮面贴纸，以及瓶子之类的曲面物体，都会把二维码的一部分变成镜子；相机看到的是一片白斑，而不是方块。解决办法：印刷品选择哑光表面，把二维码放在产品最平整的部位；隔着玻璃扫码时，把手机稍微倾斜或侧移，让反光移出码面。
打印破损或分辨率过低。 吸水性强的纸上油墨晕开、截图放大后模糊、标签撕裂、热敏小票在阳光下褪色——这些都会破坏图案。解决办法是从正规来源重新输出：印刷用矢量文件（SVG），或使用约300 dpi的高分辨率PNG——这是印刷质量的常用经验值。如果二维码本身已经破损或褪色，那就无法修复，只能更换。
长宽比被拉伸。 在设计或文档工具里拖动边框把手，会把方块拉成长方形，而扫码软件认的是正方形。把二维码硬塞进横幅或侧边栏时，这种情况屡见不鲜。解决办法：只从角上的把手按锁定比例缩放，或者更好的做法是按所需尺寸重新生成。二维码一旦变形，怎么编辑都救不回来——重新生成一个吧。
能扫出来，却什么也没发生
链接失效或动态码过期。 有时图案完好无损，手机瞬间就读出来了——但目标页面打不开。页面被删除了，域名过期了，或者这是一个动态码，背后的跳转服务已到期——免费试用结束后这种情况很常见。解决办法：先在电脑浏览器里打开链接，确认问题出在目标地址而不是码本身。静态码的网址是直接编进图案里的，只能重新生成一个指向有效地址的新码。动态码可以通过续费修复——或者干脆换成静态码，指向你自己域名下不会失效的地址。
相机与距离问题
对焦问题。 镜头有指纹、贴膜开裂，或者手机凑得比最近对焦距离还近，都会让方块模糊到无法识别。解决办法：擦干净镜头（它特别容易积口袋里的绒毛），在屏幕上点一下二维码强制对焦，握稳手机或找个东西靠着，再退后几厘米——很多手机的相机在太近的距离上无法对焦，而人们往往就举那么近。
距离太近或太远。 太近，二维码占满整个画面，四周看不到边距，很多扫码软件会拒绝识别；太远，方块就糊成一片灰噪点。一个实用的起点：让二维码占据画面大部分，同时四周留出一圈清晰的背景，小尺寸印刷码大约保持20–30厘米距离，然后再微调。动作放慢——扫码软件需要一点时间锁定。
快速排查清单
- 深色模块配浅色背景？如果不是，反色或改色。
- 四周留白至少四个模块宽？
- 尺寸至少达到扫码距离的十分之一？
- 方块还是正方形，没有被拉伸？
- Logo够小，纠错等级设为高？
- 表面哑光、无反光、放置平整？
- 用矢量文件或高分辨率图片打印？
- 链接在电脑浏览器里能打开？
- 镜头干净，整个码在画面内且四周有可见边距？
任何一条答"否"，你就找到问题了。
核心要点
大多数扫不出来的二维码，败在很平常的原因上：对比度弱、缺少留白区、数据太多导致图案过密，或者链接早已失效。改好设计，用高质量的源文件打印，最重要的是——在印五千份之前，先用几部不同的手机测试成品码。十秒钟的测试，胜过一次重印。