若要在 Python 中將十六進位色碼轉換為 RGB,請驗證 CSS 十六進位詞元、展開任何縮寫形式,並以 16 為基數解析每組通道配對,產生 0 到 255 的紅色、綠色與藍色整數。
CSS 顏色也可能包含 alpha 位元組。Python 可以對不透明詞元傳回 3 個通道整數,或對半透明詞元傳回 4 個通道整數,但應保留 CSS 的紅色、綠色、藍色、alpha 順序,並拒絕格式錯誤的值,而不是加以猜測。

CSS 十六進位表示法如何對應至 RGB
每個兩位數的 CSS 元件都是一個十六進位位元組。數字 0 到 9 與字母 A 到 F 是 16 進位字元,而每組完整的配對都會對應至 0 到 255 的整數。前置的井號表示該值為十六進位。
| CSS 形式 | 展開方式 | 解析後的元件 | Alpha 處理方式 |
|---|---|---|---|
| #RGB | 重複每個數字 | 紅色、綠色、藍色 | 未指定;預覽為不透明 |
| #RGBA | 重複每個數字 | 紅色、綠色、藍色、alpha | Alpha 是最後一個位元組 |
| #RRGGBB | 不需要展開 | 紅色、綠色、藍色 | 未指定;預覽為不透明 |
| #RRGGBBAA | 不需要展開 | 紅色、綠色、藍色、alpha | Alpha 是最後一個位元組 |
縮寫形式會重複每個數字,因此其單數字元件會在轉換前變成完整的位元組。在 CSS 中,alpha 一律位於最後:#RRGGBBAA 中的配對依序代表紅色、綠色、藍色,然後是 alpha。不要套用將不透明度置於前方的色彩設計慣例。W3C CSS Color Level 4 十六進位表示法與MDN 的 hex-color 參考資料均有記載這些規則。
在 Python 中將十六進位色碼轉換為 RGB
- 修剪完整輸入。 使用 strip() 移除詞元周圍的一般空白字元,但讓值內部的空白保持可見,以便進行驗證。
- 要求井號與有效長度。 井號後的字元必須恰好包含 3、4、6 或 8 個十六進位數字。
- 拒絕非十六進位字元。 將每個字元與數字 0 到 9 及不分大小寫的字母 A 到 F 進行比對。
- 展開縮寫形式。 對於 3 位數與 4 位數形式,重複每個數字,將每個半位元組轉換為完整的位元組。
- 解析通道配對。 將每組 2 個字元的配對傳給 Python 的 int(),並將基數設為 16。
- 傳回適當的 tuple。 對 #RGB 與 #RRGGBB 傳回 3 個整數,或對包含 alpha 的形式傳回 4 個整數。
完整函式:
def hex_to_rgb(hex_color):
value = hex_color.strip()
if not value.startswith("#"):
raise ValueError("Hex color must start with #")
digits = value[1:]
if len(digits) not in (3, 4, 6, 8):
raise ValueError("Use 3, 4, 6, or 8 hexadecimal digits")
if any(char not in "0123456789abcdefABCDEF" for char in digits):
raise ValueError("Color contains a non-hexadecimal character")
if len(digits) in (3, 4):
digits = "".join(char * 2 for char in digits)
channels = [int(digits[i:i + 2], 16) for i in range(0, len(digits), 2)]
return tuple(channels)
此函式僅使用 Python 內建功能。具體的呼叫會擷取 3 個色彩通道,並在來源未提供 alpha 時將其保留為未設定狀態:
channels = hex_to_rgb("#123")
r, g, b = channels[:3]
alpha_byte = channels[3] if len(channels) == 4 else None
對於 #123,展開縮寫形式後會產生 #112233,而以 16 為基數解析各組配對後會得到紅色 17、綠色 34 與藍色 51,因此傳回的 tuple 為 (17, 34, 51)。
此函式會傳回原始通道位元組。它不會在未提供 alpha 時,悄悄將其轉換為十進位不透明度,也不會變更通道順序。若要使用 CSS 形式的不透明度,請將第 4 個位元組除以 255。
選擇應用程式所需的輸出
成功解析後可以產生數種實用形式,但這些形式並不能彼此替代。請依據目的地接受的格式,以及原始 alpha 位元組是否必須保持精確來選擇。
| 輸出 | 結構 | 最適用的情境 | 精確度注意事項 |
|---|---|---|---|
| Python RGB tuple | 3 個整數位元組 | 需要紅色、綠色與藍色的程式碼 | 不包含 alpha 成員 |
| Python RGBA tuple | 3 個色彩位元組加上一個 alpha 位元組 | 明確支援 RGBA 的程式碼 | Alpha 保留為 0 到 255 的整數 |
| CSS rgb() 或 rgba() | 可直接用於樣式表的文字 | 網頁樣式與 CSS 值 | 顯示時會將十進位 alpha 四捨五入 |
| 標準化 HEX | 展開後的小寫 CSS 詞元 | 精確傳遞或往返轉換 | 完全保留 alpha 位元組 |
若要使用個別通道值進行 API、canvas 操作、影像編輯器、測試 fixture 或設計 token,請採用個別通道值。若要在接受 rgb() 或 rgba() 的樣式中使用 CSS 輸出,請採用 CSS 輸出。若要進行精確的往返轉換,尤其是當短十進位數無法清楚表示 alpha 時,請保留標準化 HEX。
若要從傳回的 tuple 建立易讀的 CSS 字串:
def channels_to_css(channels):
r, g, b = channels[:3]
if len(channels) == 4:
alpha_text = f"{channels[3] / 255:.3f}".rstrip("0").rstrip(".")
return f"rgba({r}, {g}, {b}, {alpha_text})"
return f"rgb({r}, {g}, {b})"
此輔助函式最多以 3 個小數位顯示 alpha,並移除尾端的 0。它不會取代 tuple 中的精確位元組,因此在精確度重要時,請保留該 tuple 或標準化 HEX。
拒絕格式錯誤的顏色詞元
嚴格驗證可避免拼字錯誤被當成看似合理但實際錯誤的顏色。解析器在修剪完整詞元周圍的一般空白字元後,刻意只接受 4 種 CSS 十六進位形式。
- 拒絕沒有前置井號的值。
- 拒絕 3、4、6 或 8 以外的任何數字數量。
- 拒絕重複的井號,不會悄悄加以修正。
- 拒絕詞元內部的空白字元。
- 拒絕十六進位字母表以外的字元。
大寫與小寫字母是等價的。轉換器不會解析具名顏色,例如 rebeccapurple、hsl()、lab()、lch()、color()、系統顏色、CSS 變數、漸層或以逗號分隔的調色盤。它也不會在色彩空間之間進行轉換,因此原本供其他色彩模型使用的輸入,不應當作 CSS 十六進位表示法傳入。
在瀏覽器中檢查轉換結果
當 Python 的結果需要再次檢查時,請將相同詞元貼入HEX to RGB Converter。它會同時顯示標準化詞元、CSS 輸出、各個位元組與視覺化結果,且無需將顏色字串上傳至 Lizely。
- 貼上 CSS 顏色。 輸入以 # 開頭、採 3 位數、4 位數、6 位數或 8 位數形式的值。
- 讀取每種表示法。 將展開後的小寫 HEX、CSS rgb() 或 rgba() 字串,以及個別通道值與 Python 輸出進行比對。
- 檢查預覽。 可將其作為快速檢查通道順序是否有明顯錯誤的方法。對於半透明顏色,當往返轉換的精確度很重要時,請保留精確的 alpha 位元組或標準化的 8 位數 HEX。
解析、格式化、驗證與預覽算繪都在目前的瀏覽器本機執行。3 位數與 6 位數顏色在預覽中會視為完全不透明,而 4 位數與 8 位數顏色則包含透明度。無效或空白輸入會以清楚的錯誤訊息取代先前的轉換結果,而不會讓過期的成功結果繼續顯示。
套用結果而不改變其意義
將 RGB 值插入程式碼之前,請確認目的地需要的是 3 個通道、4 個通道,還是 CSS 字串。接受整數 RGB 的 API 應直接接收原始位元組值。如果它需要 0 到 1 的 alpha 值,請明確進行該項轉換,而不是將 CSS 形式的十進位數直接複製到解讀方式不同的 API 中。
十六進位 CSS 顏色代表的是 sRGB 通道值,而不是 Pantone 顏色、CMYK 墨色配方或實體量測值。如果下一項任務是檢查文字可讀性,請使用Color Contrast Checker。若要進行基本的印刷色彩估算,請使用RGB to CMYK Converter,同時請記得,可靠的印刷製作仍需要受管理的描述檔與打樣工作流程。
即時預覽是視覺上的合理性檢查,而不是色彩管理參考資料。顯示器亮度、瀏覽器描述檔、環境光與廣色域工作流程,都可能讓相同的數值 sRGB 顏色在不同螢幕上呈現不同外觀。進行資料交換時,請依賴通道值或精確的來源詞元,而不是根據預覽判斷等價性。
若你正在評估各種選項,RGB to CMYK Accuracy: A Practical Browser Guide有更詳細的說明。
若你正在評估各種選項,How to Avoid RGB to HEX Mistakes Before You Copy有更詳細的說明。