二维码生成后扫不出来？先查尺寸、留白、对比度和压缩

二维码在电脑上放大时能扫，塞进海报角落后却怎么也识别不了。换一台手机偶尔成功，打印出来又完全失败。

这种问题不能只看二维码内容是否正确。最终尺寸、四周留白、前景与背景对比、图片压缩和印刷质量都会影响识别。没有一个适合所有屏幕、纸张和扫描距离的万能像素值，必须回到真实使用场景测试。

先在最终尺寸上测试

图注：二维码能生成不等于在最终场景里能稳定识别。

不要只把二维码放大到屏幕中央测试。把它放进最终海报、菜单、包装或网页，按真实显示尺寸打开，再用不同距离扫码。

二维码在编辑器里清楚，不代表导出后仍有足够的模块尺寸。若被缩得太小，相邻黑白块会粘连；若打印设备分辨率不足，边缘也可能发虚。先增加实际占用空间，再考虑其他装饰。

四周留白不要被文字和边框挤掉

二维码外围需要完整、干净的留白，帮助扫描器找到边界。把标题、边框、logo 或背景纹理贴得太近，都会让识别区域变得混乱。

检查时不要只看正方形内部。沿四条边走一圈，确认留白连续，没有文字压线、圆角卡片遮挡或裁切贴边。若版面空间不足，优先缩小旁边装饰，而不是压缩二维码边界。

前景和背景要有稳定对比

深色码配浅色背景通常更容易识别。渐变、照片纹理、透明叠加或反色设计可能在某些区域降低对比。看起来“更有设计感”，不等于摄像头更容易分辨。

若必须放在照片上，可以先加一块干净底板。颜色是否好看由设计判断，是否能扫则必须由真实设备测试。不要只依赖软件预览中的对比度感觉。

压缩、截图和转发会改变边缘

二维码导出后又被截图、缩放、聊天软件压缩或转成低质量 JPG，边缘可能变软。尽量使用原始导出文件，避免在多个平台之间反复下载再上传。

收到最终文件后重新检查像素尺寸，并用至少两台设备或两个扫码应用测试。若原文件能扫、转发后的文件不能扫，问题在交付链路，不必重新生成二维码内容。

先验证内容，再验证画面

扫码成功后还要核对结果：网址是否完整、是否使用正确协议、文本有没有多余空格、条形码内容是否与订单或商品一致。能识别不等于内容正确。

你可以在二维码与条形码工具生成或解码内容，再把结果放进最终版面，按“尺寸、留白、对比度、压缩”四项逐一测试。工具负责生成和解码；最终海报、屏幕和印刷物能不能稳定识别，仍需要在真实交付环境里验收。