QR Code 顏色對比度:要緊的是明暗,不是色相

本文目錄
QR Code 的顏色對比度,歸結起來就是每種顏色的一個數字:它有多亮。開源解碼器 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 中說,QR Code 掃描器使用紅光,所以白底上的紅色碼讀不出來,綠底上的藍色碼也讀不出來。它的基本建議是白底黑碼。如果你的碼會被紅光掃描器讀取,色相也就有影響了。我們沒有核實手機相機應用是如何把顏色轉成灰度的。
如何從十六進位制顏色計算相對亮度
W3C 的 WCAG 2.2 定義把相對亮度(relative luminance)歸一化為:最深的黑為 0,最亮的白為 1。對一個十六進位制顏色:
- 把十六進位制色值拆成紅、綠、藍三個通道,每個除以 255。
- 把每個值線性化:小於等於 0.04045 時除以 12.92;否則計算 ((值 + 0.055) ÷ 1.055) 的 2.4 次方。
- 加權求和:L = 0.2126 × R + 0.7152 × G + 0.0722 × B。
- 用對比度(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 是為網頁上的文字寫的,不是為 QR Code 寫的。它的對比度成功準則要求普通文字至少 4.5:1、大號文字至少 3:1,說明計算值不應四捨五入(4.499:1 達不到 4.5:1),並解釋這個計算的設計讓色相不成為關鍵因素。我們讀過的 QR Code 標準都沒有用 WCAG 的數字;我們借用這個公式,是因為它能把任何十六進位制色值變成一個公開、可重複的明暗數字。把公式倒過來算,一種顏色的 L 需要約 0.183 或更低,才能對純白達到 4.5:1(我們自己算的)。

本文繪製的示意圖;數值用 WCAG 2.2 公式計算。
我們解碼測試中的 QR Code 顏色對比度
2026 年 11 月 5 日,我們把同一個圓點原型碼(糾錯等級 H,一個短網址)渲染成五種配色,每種分別在 400、240 和 160 px 寬度下用 jsQR 和 ZXing 解碼。ZXing 這邊我們用的是 zxing-wasm,即 ZXing-C++ 的 WebAssembly 版本,不是上文引用的 Java 庫;我們沒有核查它是如何把顏色轉成灰度的。
| 配色 | 亮度或對比度 | jsQR,400 / 240 / 160 px | ZXing,400 / 240 / 160 px |
|---|---|---|---|
| 白底藏青 #1d3557(基準) | L 0.035,12.4:1 | 失敗 / 成功 / 成功 | 三種寬度都成功 |
| 五種深色,按模組混用 | L 0.035–0.082 | 失敗 / 成功 / 成功 | 三種寬度都成功 |
| 五種中間色,按模組混用 | L 0.27–0.58 | 三種寬度都失敗 | 三種寬度都失敗 |
| 粉彩 #c98aa0,底色 #fde8ef | 2.4:1 | 三種寬度都失敗 | 三種寬度都成功 |
| 藏青底淺色點(反色) | 藏青底色,深淺反轉 | 不開反色三種都失敗;開反色 3 種中 2 種成功 | 不開反色三種都失敗;開反色 3 種中 3 種成功 |

本文根據我們的解碼測試結果繪製的示意圖。
有三點值得注意。深色多色碼的解碼結果和單色藏青基準完全一樣;jsQR 在 400 px 的失敗在藏青碼上也出現了,所以原因不在顏色。中間色配色看起來同樣多彩,卻全部失敗;我們的理解是,它較淺的模組(比如對白色只有 1.7:1 的黃色)和白色背景太接近了。粉彩碼讓兩個解碼器結果不一,這也說明一次解碼成功證明不了多少。解碼器測試不能代替用真實手機掃描印刷樣張,這裡的任何結果都不保證任何設計一定能掃出來。
檢驗儀評什麼:ISO/IEC 15415 中的符號對比度
ISO/IEC 18004 規定,QR Code 符號應按照 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 個模組寬的圓角長條,覆蓋每個模組的中心。在我們釋出前的解碼測試中,織線碼在測試的每種尺寸下都能被兩個庫解碼。

截圖來自使用示例資料的演示帳號。
印彩色碼之前:
- 給每一種點的顏色算 L,不要算整個配色的平均值。
- 讓每一種點的顏色都比背景暗得多;在我們測試中能解碼的那組深色,對白色的對比度大約在 8:1 到 12.4:1 之間。
- 讓定點陣圖形保持深色,背景保持淺色。
- 用免費的QR Code 可掃性檢查檢查匯出的檔案——它計算深色模組平均色與淺色模組之間的 WCAG 比值,低於 4.5:1 就會標出來——然後用幾部手機掃一張印刷樣張。
想在點下面放圖片,看藝術 QR Code 為什麼還能掃;想按場景找配色靈感,看QR Code 設計靈感。
常見問題
QR Code 可以是任何顏色嗎?
點可以是任何比背景深得多的顏色,因為我們讀過的開源解碼器程式碼會把顏色歸結為亮度。DENSO WAVE 的 FAQ 補充說,紅光掃描器讀不出白底上的紅色碼,所以要在你的受眾實際使用的掃描器上測試顏色。
QR Code 應該有多大的對比度?
我們讀過的 QR Code 標準都沒有規定 WCAG 比值。檢驗儀根據測得的反射率給符號對比度評級,Cognex 的手冊中 70% 及以上為 A。作為一條篩選規則:在我們的測試中能解碼的深色,對白色的對比度大約在 8:1 或以上。
為什麼我的黃色或金色 QR Code 掃不出來?
黃色是淺色。#f2c14e 的相對亮度是 0.576,對白色的對比度只有 1.7:1,所以解碼器看到的是白底上的淺灰點。點用深色,黃色放在邊框裡。
反色 QR Code 能用嗎?
標準允許深底淺碼,但解碼器必須嘗試反色影像。在我們的測試中,不開反色時兩個解碼器都失敗了;我們沒有測試手機相機應用,所以淺底深碼是更穩妥的選擇。
參考來源
- W3C — Web Content Accessibility Guidelines (WCAG) 2.2: relative luminance and contrast ratio definitions. W3C Recommendation, published 12 December 2024. Accessed 5 November 2026.
- jsQR project — src/binarizer/index.ts. Undated source file. Accessed 5 November 2026.
- ZXing project — RGBLuminanceSource.java. Undated source file. Accessed 5 November 2026.
- 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.
- DENSO WAVE — FAQ. QRcode.com, undated. Accessed 5 November 2026.
- W3C WAI — Understanding Success Criterion 1.4.3: Contrast (Minimum). Updated 6 September 2026. Accessed 5 November 2026.
- zxing-wasm project — README. Undated. Accessed 5 November 2026.
- Cognex — ISO/IEC 15415 Grading Parameters, DataMan 475V Verifier Reference Manual. Dated 13 August 2020. Accessed 5 November 2026. (vendor data)
- Axicon — ISO/IEC standard for 2D barcodes. Undated. Accessed 5 November 2026. (vendor data)
- ISO — ISO/IEC 18004:2024 standard page. Fourth edition, published August 2024. Accessed 5 November 2026.
- ZXing project — MultiFormatReader.java. Undated source file. Accessed 5 November 2026.
- ZXing project — DecodeHintType.java. Undated source file. Accessed 5 November 2026.
- jsQR project — README. Undated. Accessed 5 November 2026.