Base64 是將二進位資料轉換為 64 個可列印字元 (A-Z, a-z, 0-9, +, /) 的編碼方式,常用於 Email (MIME)、XML 資料嵌入、URL 參數傳遞等場合。Python base64 模組提供完整的標準與變體支援,本文詳細說明用法與注意事項。
= 補齊>> import base64
>>> s = 'haha'
>>> encoded = base64.b64encode(s.encode()) # Python 3 需先 encode 為 bytes
>>> encoded
b'aGFoYQ=='
>>> base64.b64decode(encoded)
b'haha'
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/b32decode | A-Z, 2-7 | 大小寫不敏感、人工較易閱讀 (RFC 4648) |
b16encode/b16decode | 0-9, A-F | 十六進位編碼 (等同 hex) |
b64encode(bytes)、b64decode(bytes|str) 回傳 bytes,需自行 .decode() 成字串。+///=,若用於 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、資料庫、設定檔) 選擇適當變體,避免後續轉換麻煩。