跳到正文
← 全部文章

二维码颜色对比度:要紧的是明暗,不是色相

2026-11-07 · 约 7 分钟读完

二维码颜色对比度:要紧的是明暗,不是色相

本文目录
  1. 为什么扫码器看的是明暗,不是色相
  2. 如何从十六进制颜色计算相对亮度
  3. 我们解码测试中的二维码颜色对比度
  4. 检验仪评什么:ISO/IEC 15415 中的符号对比度
  5. 浅色码配深色底需要解码器支持反色
  6. 改形状,不改明暗
  7. 常见问题
  8. 参考来源

二维码的颜色对比度,归结起来就是每种颜色的一个数字:它有多亮。开源解码器 jsQR 和 ZXing 的 Java 库在读取任何内容之前,都会先把每个像素变成一个灰度值,所以色相就不起作用了。藏青和深紫读出来是深色;珊瑚色读出来是中灰,黄色和粉彩粉色读出来是浅灰。这个明暗可以用 W3C 的相对亮度公式从十六进制色值算出来。

事实核查于 2026 年 11 月 5 日。

为什么扫码器看的是明暗,不是色相

jsQR 库第一步就是把图像转成灰度,对每个像素 0–255 的通道按 0.2126 × 红 + 0.7152 × 绿 + 0.0722 × 蓝 加权。ZXing 的 Java 库在收到 RGB 像素时,计算的是其源代码里所说的「偏重绿色的平均值」:(红 + 2 × 绿 + 蓝) ÷ 4。两个公式都给每个像素一个亮度数字。按我们的理解,两种亮度相同的颜色,不管色相如何,在这些解码器看来都一模一样。

标准本身也把每个模块归为两个值之一。ISO/IEC 18004 的 2006 年版中的参考解码流程,在每个网格点采样一块 3 × 3 像素的区域,再用一个全局阈值判定「深还是浅」。

有一个例外对印刷很重要。DENSO WAVE 在其 FAQ 中说,二维码扫描器使用红光,所以白底上的红色码读不出来,绿底上的蓝色码也读不出来。它的基本建议是白底黑码。如果你的码会被红光扫描器读取,色相也就有影响了。我们没有核实手机相机应用是如何把颜色转成灰度的。

如何从十六进制颜色计算相对亮度

W3C 的 WCAG 2.2 定义把相对亮度(relative luminance)归一化为:最深的黑为 0,最亮的白为 1。对一个十六进制颜色:

  1. 把十六进制色值拆成红、绿、蓝三个通道,每个除以 255。
  2. 把每个值线性化:小于等于 0.04045 时除以 12.92;否则计算 ((值 + 0.055) ÷ 1.055) 的 2.4 次方。
  3. 加权求和:L = 0.2126 × R + 0.7152 × G + 0.0722 × B。
  4. 用对比度(contrast ratio)比较两种颜色:(L1 + 0.05) ÷ (L2 + 0.05),其中 L1 是较亮的那种颜色。比值范围从 1:1 到 21:1。

算例:藏青 #1d3557。 三个通道是 29、53 和 87,除以 255 后是 0.1137、0.2078 和 0.3412。三个值都大于 0.04045,所以线性化后是 0.0123、0.0356 和 0.0953。加权:0.0026 + 0.0255 + 0.0069 = 0.035。对白色(L = 1)的比值是 1.05 ÷ 0.085 = 12.4:1。

WCAG 是为网页上的文字写的,不是为二维码写的。它的对比度成功准则要求普通文字至少 4.5:1、大号文字至少 3:1,说明计算值不应四舍五入(4.499:1 达不到 4.5:1),并解释这个计算的设计让色相不成为关键因素。我们读过的二维码标准都没有用 WCAG 的数字;我们借用这个公式,是因为它能把任何十六进制色值变成一个公开、可重复的明暗数字。把公式倒过来算,一种颜色的 L 需要约 0.183 或更低,才能对纯白达到 4.5:1(我们自己算的)。

一排十个色块,从黑到白,每块标出十六进制色值、WCAG 相对亮度和对白色的对比度:黑 0.000、21.0:1,藏青 #1d3557 0.035、12.4:1,紫 #7b1fa2 0.078、8.2:1,红 #d7261e 0.159、5.0:1,蓝 #1565c0 0.133、5.7:1,绿 #2e7d32 0.155、5.1:1,珊瑚 #e76f51 0.290、3.1:1,黄 #f2c14e 0.576、1.7:1,粉 #f8bbd0 0.601、1.6:1,白 1.000、1.0:1

本文绘制的示意图;数值用 WCAG 2.2 公式计算。

我们解码测试中的二维码颜色对比度

2026 年 11 月 5 日,我们把同一个圆点原型码(纠错等级 H,一个短链)渲染成五种配色,每种分别在 400、240 和 160 px 宽度下用 jsQR 和 ZXing 解码。ZXing 这边我们用的是 zxing-wasm,即 ZXing-C++ 的 WebAssembly 版本,不是上文引用的 Java 库;我们没有核查它是如何把颜色转成灰度的。

配色亮度或对比度jsQR,400 / 240 / 160 pxZXing,400 / 240 / 160 px
白底藏青 #1d3557(基准)L 0.035,12.4:1失败 / 成功 / 成功三种宽度都成功
五种深色,按模块混用L 0.035–0.082失败 / 成功 / 成功三种宽度都成功
五种中间色,按模块混用L 0.27–0.58三种宽度都失败三种宽度都失败
粉彩 #c98aa0,底色 #fde8ef2.4:1三种宽度都失败三种宽度都成功
藏青底浅色点(反色)藏青底色,深浅反转不开反色三种都失败;开反色 3 种中 2 种成功不开反色三种都失败;开反色 3 种中 3 种成功

同一个二维码的五个版本,每个解码器、每种宽度配一个绿色或红色标记:白底藏青点、五种深色、五种中间色、浅粉底粉彩粉色、藏青底浅色点

本文根据我们的解码测试结果绘制的示意图。

有三点值得注意。深色多色码的解码结果和单色藏青基准完全一样;jsQR 在 400 px 的失败在藏青码上也出现了,所以原因不在颜色。中间色配色看起来同样多彩,却全部失败;我们的理解是,它较浅的模块(比如对白色只有 1.7:1 的黄色)和白色背景太接近了。粉彩码让两个解码器结果不一,这也说明一次解码成功证明不了多少。解码器测试不能代替用真实手机扫描印刷样张,这里的任何结果都不保证任何设计一定能扫出来。

检验仪评什么:ISO/IEC 15415 中的符号对比度

ISO/IEC 18004 规定,二维码符号应按照 ISO/IEC 15415 的二维印刷质量指南评估质量。2006 年版还规定每次扫描的等级取其各项参数等级(包括符号对比度)中的最低者,符号的总等级取多次扫描的平均值。我们没有读过 ISO/IEC 15415 本身,所以下面的细节来自检验仪厂商(厂商文档)。

Cognex 的 DataMan 475V 检验仪手册把符号对比度定义为最亮模块与最暗模块之间的反射率差,70% 及以上评 A,55% 起评 B,40% 起评 C,20% 起评 D,低于 20% 评 F。Axicon 称,2024 版 ISO/IEC 15415 改为用最亮和最暗的 1% 像素来测量符号对比度,而不是单个最亮值和最暗值。

符号对比度是对印刷出来的码做的反射率测量,不是从十六进制色值算出来的数字;我们也没有找到任何公开的、从 WCAG 比值换算成符号对比度百分比的方法。用公式在屏幕上筛选颜色;用检验仪或印刷样张来判断印刷效果。

浅色码配深色底需要解码器支持反色

ISO/IEC 18004 的 2006 年版说,符号设计为可以读取浅底深码或深底浅码两种,其解码流程会根据定位图形识别反射极性。ISO 在 2024 年 8 月发布了第四版,我们没有读过。

各解码器处理反色的方式不同。ZXing 的 Java 版 MultiFormatReader 只有在调用方设置了 ALSO_INVERTED 提示时,才会用反色图像重试。jsQR 默认两种都试,性能代价约 50%,它的 README 还说默认值很可能会改成不反色。在我们的测试中,我们对两个库都明确地关闭和开启反色,反色码只要关闭反色就每次都失败。如果你的版面是深色的,就把码放在一块浅色底板上;排查清单讲了这个修法。

改形状,不改明暗

想让码看起来不一样、又不动它的明暗,就改点的形状。在 QR Maker AI 的编辑器里,样式 → 点形状 中有「织线」和「竖织线」,截至 2026 年 11 月是 Pro 功能(见价格)。它们把一行或一列中连续的深色模块连成一根 0.76 个模块宽的圆角长条,覆盖每个模块的中心。在我们发布前的解码测试中,织线码在测试的每种尺寸下都能被两个库解码。

编辑器的样式面板中,点形状在圆形、连笔圆角、织线和竖织线之间切换,码始终是白底黑码

截图来自使用示例数据的演示账号。

印彩色码之前:

  1. 给每一种点的颜色算 L,不要算整个配色的平均值。
  2. 让每一种点的颜色都比背景暗得多;在我们测试中能解码的那组深色,对白色的对比度大约在 8:1 到 12.4:1 之间。
  3. 让定位图形保持深色,背景保持浅色。
  4. 用免费的二维码可扫性检查检查导出的文件——它计算深色模块平均色与浅色模块之间的 WCAG 比值,低于 4.5:1 就会标出来——然后用几部手机扫一张印刷样张。

想在点下面放图片,看艺术二维码为什么还能扫;想按场景找配色灵感,看二维码设计灵感。

常见问题

二维码可以是任何颜色吗?

点可以是任何比背景深得多的颜色,因为我们读过的开源解码器代码会把颜色归结为亮度。DENSO WAVE 的 FAQ 补充说,红光扫描器读不出白底上的红色码,所以要在你的受众实际使用的扫描器上测试颜色。

二维码应该有多大的对比度?

我们读过的二维码标准都没有规定 WCAG 比值。检验仪根据测得的反射率给符号对比度评级,Cognex 的手册中 70% 及以上为 A。作为一条筛选规则:在我们的测试中能解码的深色,对白色的对比度大约在 8:1 或以上。

为什么我的黄色或金色二维码扫不出来?

黄色是浅色。#f2c14e 的相对亮度是 0.576,对白色的对比度只有 1.7:1,所以解码器看到的是白底上的浅灰点。点用深色,黄色放在边框里。

反色二维码能用吗?

标准允许深底浅码,但解码器必须尝试反色图像。在我们的测试中,不开反色时两个解码器都失败了;我们没有测试手机相机应用,所以浅底深码是更稳妥的选择。

参考来源

  1. W3C — Web Content Accessibility Guidelines (WCAG) 2.2: relative luminance and contrast ratio definitions. W3C Recommendation, published 12 December 2024. Accessed 5 November 2026.
  2. jsQR project — src/binarizer/index.ts. Undated source file. Accessed 5 November 2026.
  3. ZXing project — RGBLuminanceSource.java. Undated source file. Accessed 5 November 2026.
  4. ISO/IEC — ISO/IEC 18004:2006, QR Code 2005 bar code symbology specification. Second edition, published 1 September 2006 (copy hosted by Public.Resource.Org). Accessed 5 November 2026.
  5. DENSO WAVE — FAQ. QRcode.com, undated. Accessed 5 November 2026.
  6. W3C WAI — Understanding Success Criterion 1.4.3: Contrast (Minimum). Updated 6 September 2026. Accessed 5 November 2026.
  7. zxing-wasm project — README. Undated. Accessed 5 November 2026.
  8. Cognex — ISO/IEC 15415 Grading Parameters, DataMan 475V Verifier Reference Manual. Dated 13 August 2020. Accessed 5 November 2026. (vendor data)
  9. Axicon — ISO/IEC standard for 2D barcodes. Undated. Accessed 5 November 2026. (vendor data)
  10. ISO — ISO/IEC 18004:2024 standard page. Fourth edition, published August 2024. Accessed 5 November 2026.
  11. ZXing project — MultiFormatReader.java. Undated source file. Accessed 5 November 2026.
  12. ZXing project — DecodeHintType.java. Undated source file. Accessed 5 November 2026.
  13. jsQR project — README. Undated. Accessed 5 November 2026.

免费创建一个动态二维码:印出去后也能随时改链接,每次扫码都有统计。

用这款设计开始 →