Base64 解決的問題

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

Base64、Base58 與 Base32 解析:各種編碼該在何時、如何使用

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 是精簡與通用性之間的最佳平衡點。