萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> 程式語言綜合

Python base64 編解碼完整指南:標準、URL 安全與變體

Base64 是將二進位資料轉換為 64 個可列印字元 (A-Z, a-z, 0-9, +, /) 的編碼方式,常用於 Email (MIME)、XML 資料嵌入、URL 參數傳遞等場合。Python base64 模組提供完整的標準與變體支援,本文詳細說明用法與注意事項。

Base64 基本原理

  • 3 位元組 (24 bits) → 4 個 Base64 字元 (每 6 bits 對應一字元)
  • 編碼後長度約為原始資料的 4/3
  • 不足 3 位元組時以 = 補齊

標準編解碼

>> import base64
>>> s = 'haha'
>>> encoded = base64.b64encode(s.encode())  # Python 3 需先 encode 為 bytes
>>> encoded
b'aGFoYQ=='
>>> base64.b64decode(encoded)
b'haha'

URL 安全變體 (urlsafe_b64encode)

標準 Base64 的 +、/ 在 URL 中需轉義 (%2B, %2F);URL 安全版以 -、_ 取代,且不補 =:

>> base64.urlsafe_b64encode(b'data+with/slashes')
b'ZGF0YS13aXRoX3NsYXNoZXM'
>>> base64.urlsafe_b64decode(b'ZGF0YS13aXRoX3NsYXNoZXM')
b'data+with/slashes'

自訂替換字元 (altchars)

>> base64.b64encode(b'data+/', altchars=b'-_')
b'ZGF0YS1f'
>>> base64.b64decode(b'ZGF0YS1f', altchars=b'-_')
b'data+/'

其他編碼變體

函數字元集用途
b32encode/b32decodeA-Z, 2-7大小寫不敏感、人工較易閱讀 (RFC 4648)
b16encode/b16decode0-9, A-F十六進位編碼 (等同 hex)

實務注意事項

  • Python 3 必須處理 bytes:b64encode(bytes)、b64decode(bytes|str) 回傳 bytes,需自行 .decode() 成字串。
  • 資料庫儲存:標準 Base64 含 +///=,若用於 SQL LIKE 模式查詢,% 為萬用字元會衝突,建議用 URL 安全版或轉義。
  • 大檔案串流編碼:使用 base64.encode(input_file, output_file) / decode() 避免一次讀入記憶體。

快速參考表

# 標準
base64.b64encode(data)          -> bytes
base64.b64decode(encoded)       -> bytes

# URL 安全 (無 padding)
base64.urlsafe_b64encode(data)  -> bytes
base64.urlsafe_b64decode(enc)   -> bytes

# 自訂替換字元 (長度 2 bytes)
base64.b64encode(data, altchars=b'-_')
base64.b64decode(enc, altchars=b'-_')

根據使用場景 (Email、URL、資料庫、設定檔) 選擇適當變體,避免後續轉換麻煩。

copyright © 萬盛學電腦網 all rights reserved