若要在 Python 中將十六進位色碼轉換為 RGB,請驗證 CSS 十六進位詞元、展開任何縮寫形式,並以 16 為基數解析每組通道配對,產生 0 到 255 的紅色、綠色與藍色整數。

CSS 顏色也可能包含 alpha 位元組。Python 可以對不透明詞元傳回 3 個通道整數,或對半透明詞元傳回 4 個通道整數,但應保留 CSS 的紅色、綠色、藍色、alpha 順序,並拒絕格式錯誤的值,而不是加以猜測。

convert hex to rgb python
在 Python 中將 HEX 轉換為 RGB:完整程式碼指南

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

  1. 修剪完整輸入。 使用 strip() 移除詞元周圍的一般空白字元,但讓值內部的空白保持可見,以便進行驗證。
  2. 要求井號與有效長度。 井號後的字元必須恰好包含 3、4、6 或 8 個十六進位數字。
  3. 拒絕非十六進位字元。 將每個字元與數字 0 到 9 及不分大小寫的字母 A 到 F 進行比對。
  4. 展開縮寫形式。 對於 3 位數與 4 位數形式,重複每個數字,將每個半位元組轉換為完整的位元組。
  5. 解析通道配對。 將每組 2 個字元的配對傳給 Python 的 int(),並將基數設為 16。
  6. 傳回適當的 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。

  1. 貼上 CSS 顏色。 輸入以 # 開頭、採 3 位數、4 位數、6 位數或 8 位數形式的值。
  2. 讀取每種表示法。 將展開後的小寫 HEX、CSS rgb() 或 rgba() 字串,以及個別通道值與 Python 輸出進行比對。
  3. 檢查預覽。 可將其作為快速檢查通道順序是否有明顯錯誤的方法。對於半透明顏色,當往返轉換的精確度很重要時,請保留精確的 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有更詳細的說明。