本文提到的工具
邊閱讀邊在瀏覽器中開啟工具,立即試試整個流程。
Base64 解決的問題
二進位資料(圖片、音訊、可執行檔)是由數值介於 0 到 255 的位元組組成的串流。許多以文字為基礎的協定(電子郵件、HTTP 標頭、JSON、XML)在設計時,只處理這些數值的一個子集:可列印的 ASCII 字元。當二進位資料未經編碼就通過這些系統時,超出可列印範圍的位元組會被破壞或誤解。

Base64 的解法,是把任意二進位資料轉成只含安全、可列印 ASCII 字元的字串。 產生的字串可以通過任何以文字為基礎的系統而不被破壞。
Base64 的內部運作方式
Base64 使用 64 個字元的字母表:A-Z(26)、a-z(26)、0-9(10)、+ 與 /,剛好 64 個字元,可以用 6 位元(2⁶ = 64)表示。
演算法每次處理 3 個位元組(24 位元),把它們切成四組 6 位元,再把每一組對應到字母表:
輸入位元組: M a n
二進位: 01001101 01100001 01101110
↓ 重新分成 4 × 6 位元 ↓
分組: 010011 010110 000101 101110
索引: 19 22 5 46
字元: T W F u
輸出: T W F u
填充(Padding)
當輸入長度無法被 3 整除時,會附加填充字元(=),讓輸出成為 4 個字元的倍數:
- 剩 1 個位元組 → 2 個 Base64 字元 +
== - 剩 2 個位元組 → 3 個 Base64 字元 +
= - 剩 0 個位元組 → 不需要填充
"Ma" (2 位元組)→ "TWE="
"M" (1 位元組)→ "TQ=="
"Man" (3 位元組)→ "TWFu"(無填充)
33% 的額外負擔
因為 3 個位元組會變成 4 個字元,Base64 的輸出大小一律是輸入的大約 4/3 = 133%。一張 100 KB 的圖片,Base64 表示法約為 133 KB。
把圖片以 data URI 嵌入 HTML,或在 API 請求中傳送時,這個額外負擔就很重要。對於大型檔案,以網址參照比嵌入 Base64 更好。
Base64 的變體
| 變體 | 字母表差異 | 填充 | 常見用途 |
|---|---|---|---|
| 標準 Base64 | + 與 / |
= |
電子郵件(MIME)、一般用途 |
| Base64Url | 以 - 與 _ 取代 + 與 / |
可選 | URL、JWT、Cookie |
| Base64(MIME) | 與標準相同,每 76 個字元換行 | = |
電子郵件附件 |
為什麼會有 Base64Url
標準 Base64 使用的 + 與 / 在 URL 中具有特殊意義(+ = 空格、/ = 路徑分隔符號)。Base64Url 把它們換成 - 與 _,產生可直接用於 URL、Cookie 與 HTTP 標頭的字串,不必做百分比編碼。
JWT 就是因為這個原因使用 Base64Url:三個片段(標頭、酬載、簽章)各自以 Base64Url 編碼,整個權杖可以安全地用在 Authorization 標頭或 URL 查詢參數中。
// 標準 Base64 — 可能含有 + / =
btoa('binary data with /') // "YmluYXJ5IGRhdGEgd2l0aCAvCg=="
// Base64Url — 對 URL 安全
function toBase64Url(str) {
return btoa(str)
.replace(/\+/g, '-')
.replace(/\//g, '_')
.replace(/=+$/, ''); // 可選:移除填充
}
常用語言中的編碼與解碼
JavaScript(瀏覽器與 Node.js)
// 把字串編碼成 Base64
const encoded = btoa('Hello, World!');
console.log(encoded); // "SGVsbG8sIFdvcmxkIQ=="
// 解碼
const decoded = atob('SGVsbG8sIFdvcmxkIQ==');
console.log(decoded); // "Hello, World!"
// 在 Node.js 中處理二進位資料(例如圖片)
const buffer = Buffer.from(imageBytes);
const base64 = buffer.toString('base64');
const back = Buffer.from(base64, 'base64');
// 瀏覽器:把 ArrayBuffer 的二進位資料編碼
async function arrayBufferToBase64(buffer) {
const bytes = new Uint8Array(buffer);
let binary = '';
bytes.forEach(b => (binary += String.fromCharCode(b)));
return btoa(binary);
}
btoa 的限制: 只能處理 Latin-1 字串。對於多位元組的 Unicode(表情符號、中日韓字元),必須先編碼成 UTF-8 位元組:
function encodeUnicode(str) {
return btoa(
encodeURIComponent(str).replace(/%([0-9A-F]{2})/g,
(_, p1) => String.fromCharCode(parseInt(p1, 16)))
);
}
Python
import base64
# 編碼
encoded = base64.b64encode(b'Hello, World!')
print(encoded) # b'SGVsbG8sIFdvcmxkIQ=='
# 解碼
decoded = base64.b64decode(b'SGVsbG8sIFdvcmxkIQ==')
print(decoded) # b'Hello, World!'
# 對 URL 安全的變體
url_encoded = base64.urlsafe_b64encode(b'binary+data/here')
print(url_encoded) # b'YmluYXJ5K2RhdGEvaGVyZQ==' (+ 與 / 已被取代)
Go
import (
"encoding/base64"
"fmt"
)
// 標準編碼
encoded := base64.StdEncoding.EncodeToString([]byte("Hello, World!"))
fmt.Println(encoded) // SGVsbG8sIFdvcmxkIQ==
// 對 URL 安全的編碼(無填充)
urlEncoded := base64.RawURLEncoding.EncodeToString([]byte("Hello, World!"))
fmt.Println(urlEncoded) // SGVsbG8sIFdvcmxkIQ
// 解碼
decoded, err := base64.StdEncoding.DecodeString(encoded)
Base58:比特幣的選擇
Base58 使用 58 個字元:所有英數字,再扣掉在視覺上容易混淆的 0(零)、O(大寫 O)、I(大寫 I)與 l(小寫 L)。也沒有 +、/ 或 =。
目標是產生人類能毫不混淆地閱讀、輸入與複製的字串,這對加密貨幣位址與紙錢包備份特別重要。
| 編碼 | 字元數 | 填充 | 人類易讀? | 大小額外負擔 |
|---|---|---|---|---|
| Base64 | 64 | = |
容易混淆 | 約 33% |
| Base64Url | 64 | 可選 | 在文字中容易混淆 | 約 33% |
| Base58 | 58 | 無 | 是 | 約 38% |
| Base58Check | 58+校驗碼 | 無 | 是 | 約 38% + 校驗碼 |
Base58Check(比特幣使用)會在 Base58 編碼之前,附加由 SHA-256(SHA-256(酬載)) 衍生出的 4 位元組校驗碼。這樣就能偵測抄寫錯誤。
Base32:對人類安全的 API 金鑰格式
Base32 只使用 32 個字元:A-Z 與 2-7。由於只用大寫字母和一組受限的數字,特別適用於:
- TOTP(基於時間的一次性密碼): Google Authenticator 的密鑰是以 Base32 編碼的。
- 不分大小寫的系統: 無法保留大小寫的檔案系統或識別碼。
- 口述或手動輸入: 比 Base64 少了容易混淆的字元。
代價是:Base32 比較不精簡。每 5 個位元組會變成 8 個字元(額外負擔 60%,Base64 則是 33%)。
import base64
# TOTP 密鑰的 Base32 編碼
secret = b'\x87\x65\x43\x21'
encoded = base64.b32encode(secret)
print(encoded) # b'Q5SUEG=='
# 解碼
decoded = base64.b32decode(b'Q5SUEG==')
何時該用哪種編碼
| 使用情境 | 建議的編碼 |
|---|---|
| 電子郵件附件(MIME) | 標準 Base64 |
| JWT 權杖 | Base64Url |
| URL 查詢參數 | Base64Url |
| HTML/CSS 中的 data URI | 標準 Base64 |
| 比特幣/加密貨幣位址 | Base58Check |
| TOTP 密鑰(Google Authenticator) | Base32 |
| 供人類複製的 API 金鑰 | Base58 或 Base32 |
| 放在 URL 中的檔案校驗碼 | Base64Url |
2026 年 11 月新增的功能
- 新增 Base62、Ascii85、Base45 與 Base32hex(Base45 為適用 QR 碼的 RFC 9285,Base32hex 為 RFC 4648)。
- Base64URL 模式可編碼與解碼 JWT 使用的
-、_形式,且不補=。
常見問題
Base64 有提供任何安全性嗎?
沒有。Base64 是編碼,不是加密。任何收到 Base64 字串的人都能輕易解碼。請勿把 Base64 當作「隱藏」敏感資料的方法。
為什麼 JWT 使用不帶填充的 Base64Url?
JWT 省略 = 填充字元,讓權杖對 URL 更安全(填充的 = 在 URL 中需要百分比編碼)。接收端可由字串長度推算出填充長度。大多數 JWT 函式庫都會自動處理。
可以把整個檔案編碼成 Base64 嗎?
可以,但要考慮額外負擔。1 MB 的二進位檔案轉成 Base64 後約為 1.37 MB。對於大型檔案,通常更好的做法是直接上傳檔案,再以網址參照。Base64 嵌入適合用在 HTML 或 CSS 中的小型資源,例如 favicon(幾 KB)。
data:image/png;base64,... 是什麼意思?
這是 data URI,一種把檔案內容直接嵌入 HTML 或 CSS 檔案的方式。瀏覽器會解碼 Base64,把結果當成從網址取得的圖片來使用。小型圖示(約 1 KB 以下)很適合這種做法;較大的圖片則應維持為獨立檔案。
有 Base128 或 Base256 嗎?
用更高的進位制編碼是可能的,但沒有用處:一旦超過 94 個可列印 ASCII 字元(Base94),再增加字元就會與控制字元產生歧義,或需要多位元組編碼,反而違背目的。Base64 是精簡與通用性之間的最佳平衡點。
