二维码生成中前景背景对比度与扫描成功率

先用可读性指标定义色差要求

二维码能否扫出来，关键不在于颜色是否鲜艳，而在于摄像头得到的明暗信号能否稳定区分模块和背景。设计时应同时检查前景、背景、静区和实际使用环境，不能只凭屏幕预览判断。

二维码前景通常是深色模块，背景是浅色底。这里的“对比度”指图像中明暗区域的可分辨程度，不等同于肉眼感受到的色彩冲击力。ISO/IEC 18004:2015是 QR Code 的国际标准，涉及符号结构、模块排列、静区以及印刷质量等要求；实际识别还要满足扫描器能够稳定找到边界并分割明暗区域。

相对亮度、对比度和色相是三个不同概念。红底黑码、蓝底白码看起来可能有明显色差，但摄像头或解码器会对图像进行灰度化、曝光和阈值处理。如果转换后的亮度差不足，模块边界就可能变得模糊。红色与绿色即使视觉上鲜艳，灰度值也可能接近。

识别成功率还取决于摄像头动态范围、自动曝光、反光、纸张或屏幕材料，以及二维码生成器对颜色的具体实现。相同的 PNG 在 OLED 屏幕、普通 LCD 和哑光纸张上，结果可能不同。

反色并非必然失败但默认配色更稳

传统二维码采用深色模块配浅色背景，原因是这种结构容易形成稳定的明暗分割。扫描器通常依据亮度、边缘和定位图形判断符号，并不是简单地寻找“黑色”和“白色”两个固定颜色。

因此，“白码黑底一定不能扫”并不准确。部分扫描器和解码库能够识别反色二维码，但兼容性取决于解码器版本、图像预处理、自动曝光和现场反光。反色可以用于特定场景，却不适合作为默认的通用方案。

配色风险可以按下面的顺序理解：

• 标准黑白：通常最稳，适合公共张贴、低端手机和复杂光照。
• 低灰度差：颜色看似不同，但亮度接近，容易在缩小或压缩后失效。
• 彩色前景：可以使用，但应保持与背景足够的明暗差。
• 反色：部分设备可识别，兼容性需要实测。
• 渐变背景：同一个模块在不同位置可能对应不同阈值，风险高。
• 透明背景：底图颜色不可控，可能直接破坏模块与背景的分割。

使用二维码生成工具时，优先设置深色前景和浅色背景，避免接近的灰度值。若必须采用反色、彩色或装饰背景，应在多种手机上重复测试，而不是只用生成器内置的预览扫码。

静区尺寸决定定位图形能否被找到

静区是二维码四周不放置图案、文字或边框的空白区域。它相当于符号与周围内容之间的缓冲带，帮助扫描器判断二维码从哪里开始、在哪里结束。

按照 QR Code 的通行规范，静区至少应为4 个模块宽。模块是组成二维码的最小方格，因此静区不能只按肉眼估算为几毫米。边框、底图、阴影、装饰线和文字都不应侵入这块区域。

静区的颜色也要连续。二维码主体使用黑色和白色，如果四周却被灰色图片、阴影或低对比度底色包围，定位图形仍可能找不到。主体颜色合格，并不代表整个符号合格。

二维码生成工具中的“边距”“margin”或“quiet zone”不一定表示同一种单位。有的版本使用模块数，有的实现使用像素，也可能采用其他内部定义。导出后应根据实际模块尺寸复核四周空白宽度，不要只看参数名称。

用生成工具和实测流程验证扫描成功率

制作测试样本时，固定编码内容和输出尺寸，只改变一个变量。二维码生成工具中至少应记录以下参数：

• 编码内容、纠错等级和版本。
• 前景色、背景色、静区宽度。
• 输出尺寸、PNG 或 SVG 格式。
• 是否启用圆角模块、图案装饰或背景图片。

建议制作四组样本：标准黑白、彩色高对比度、反色，以及带装饰背景的版本。若使用 SVG，要同时检查浏览器、设计软件和打印流程是否改变了颜色、透明度或边缘；位图则要避免缩放造成模块边界插值。

1. 分别在目标屏幕和目标纸张上展示或打印二维码。
2. 测试正面光、侧面光、低亮度和有反光的环境。
3. 使用不同距离、不同手机和不同摄像头进行扫描。
4. 每种条件至少重复 20 次，记录成功次数与平均识别时间。

这里的95%成功率是一个适合项目验收的实操阈值，不是所有场景都统一采用的行业标准。若目标环境低于 95%，排查顺序应为：

• 恢复深色前景与浅色背景。
• 清理并扩大静区。
• 增大输出尺寸，确保模块不会小到难以成像。
• 提高纠错等级并重新测试。
• 移除圆角、渐变、背景图和其他装饰元素。

常见纠错等级为 L、M、Q、H，对应约 7%、15%、25%、30% 的码字恢复能力。这里的比例不是“任意区域都能修复”的保证，实际效果还受二维码版本、掩模和损坏分布影响。纠错码可以应对部分污损，却不能替代足够的对比度、清晰模块和完整静区。