Base64 解碼

相關推薦

什麼是 Base64 解碼？

適用場景

• 解碼介面回傳的 Base64 欄位檢視原始內容
• 還原日誌中的 Base64 編碼資料
• 恢復設定檔中的 Base64 編碼值
• 排查 Base64 解碼報錯原因（填充缺失、非法字元等）
• 解碼 JWT Token 的 header 和 payload 段，檢視 Token 聲明
• 解碼 HTTP Basic Authentication 認證字串，檢視帳號密碼
• 還原 Data URI 中的內嵌資源（小圖示、CSS 背景等）

使用方法

1. 貼上需要解碼的 Base64 字串
2. 選擇字元集（UTF-8/ASCII/ISO-8859-1）
3. 工具自動進行 Base64 解碼並顯示結果
4. 複製解碼結果用於後續除錯或文件記錄

功能特點

• 即時雙向轉換：輸入即解碼，300ms 防抖延遲，無需手動觸發
• 多字元集支援：UTF-8、ASCII、ISO-8859-1 三種字元集，覆蓋中文/英文/多語言場景
• URL-safe Base64 相容：自動處理 - 和 _ 字元替換，支援無 Padding 格式
• 非法字元檢測：解碼失敗時提示具體錯誤位置，快速定位格式問題
• 一鍵複製與下載：支援複製解碼結果到剪貼簿，或下載為 .txt 文字檔
• JWT Token 友善：可貼上 JWT 的 header 或 payload 段快速還原原始聲明
• 本地端運算：所有解碼在瀏覽器本地完成，資料不上傳伺服器，保護隱私

程式碼範例

// 標準解碼（支援 UTF-8 中文）
function b64Decode(str) {
  return decodeURIComponent(escape(atob(str)));
}

// URL-Safe 解碼（用於 JWT / OAuth）
function b64UrlDecode(str) {
  // 先把 - 和 _ 還原為 + 和 /
  str = str.replace(/-/g, '+').replace(/_/g, '/');
  // 補齊 padding
  while (str.length % 4) str += '=';
  return decodeURIComponent(escape(atob(str)));
}

console.log(b64Decode('SGVsbG8g5LiW55WM')); // Hello 世界
console.log(b64UrlDecode('SGVsbG8g5LiW55WM')); // Hello 世界

import base64

# Standard 解碼（UTF-8）
encoded = base64.b64encode('Hello 世界'.encode('utf-8'))
decoded = base64.b64decode(encoded).decode('utf-8')
print(decoded)  # Hello 世界

# URL-Safe 解碼（用於 JWT / OAuth）
url_safe = base64.urlsafe_b64encode('Hello 世界'.encode('utf-8'))
decoded_url_safe = base64.urlsafe_b64decode(url_safe).decode('utf-8')
print(decoded_url_safe)  # Hello 世界

# 容錯解碼（自動處理缺失 padding）
def safe_b64_decode(s):
    s = s.replace('-', '+').replace('_', '/')
    s += '=' * ((4 - len(s) % 4) % 4)
    return base64.b64decode(s).decode('utf-8', errors='replace')

print(safe_b64_decode('SGVsbG8g5LiW55WM'))  # Hello 世界

import java.nio.charset.StandardCharsets;
import java.util.Base64;

public class Base64DecodeExample {
    public static void main(String[] args) {
        String encoded = "SGVsbG8g5LiW55WM";

        // Standard 解碼
        String decoded = new String(
            Base64.getDecoder().decode(encoded), StandardCharsets.UTF_8);
        System.out.println(decoded); // Hello 世界

        // URL-Safe 解碼（用於 JWT）
        String urlSafeDecoded = new String(
            Base64.getUrlDecoder().decode(encoded), StandardCharsets.UTF_8);
        System.out.println(urlSafeDecoded);

        // MIME 解碼（自動處理換行）
        String mimeEncoded = "SGVsbG8g\n5LiW55WM=";
        String mimeDecoded = new String(
            Base64.getMimeDecoder().decode(mimeEncoded), StandardCharsets.UTF_8);
        System.out.println(mimeDecoded);
    }
}

常見問題

故障排查

術語表

RFC 4648

IETF 發布的 Base16/Base32/Base64 編碼官方標準，定義了標準 Base64 和 URL-Safe Base64 兩種字母表，以及 padding、換行、非字母表字元處理等規則。是目前 Base64 編解碼的事實標準，替代了早期的 RFC 3548。URL-Safe Base64 工具Base64 Padding 工具

InvalidCharacterError

瀏覽器原生 atob API 在遇到非合法 Base64 字元時拋出的 DOMException。常見觸發原因包括混入空格、換行、引號、Tab，或是使用 URL-Safe 變體（-/_）但未轉換回標準字元（+/）。Base64 清理工具

Base64URL（URL-Safe Base64）

RFC 4648 §5 定義的 URL 安全變體。將標準 Base64 的 + 替換為 -、/ 替換為 _，並通常省略 padding 的 = 字元。廣泛用於 JWT Token、OAuth PKCE、URL 參數、檔名等場景。解碼時需要先還原成標準字元。URL-Safe Base64 工具JWT 工具

Padding（填充）

Base64 編碼結果長度必須是 4 的倍數。當輸入位元組數不是 3 的倍數時，末尾用 = 字元補齊。標準 Base64 使用 padding，Base64URL 通常省略 padding。解碼時若 padding 缺失或錯誤，會導致解碼失敗或結果長度異常。Base64 Padding 工具

btoa / atob

瀏覽器原生的 Base64 編解碼 API。btoa（binary to ASCII）用於編碼，atob（ASCII to binary）用於解碼。注意這兩個 API 只支援 Latin-1（ISO-8859-1）字元集，處理中文需配合 encodeURIComponent 和 decodeURIComponent 進行 UTF-8 轉碼。Base64 編碼工具

字元集（Charset）

把位元組對應到字元的編碼規則。Base64 編解碼本身只處理位元組，但當結果是文字時需要用正確的字元集還原。常見字元集：UTF-8（中文、日文、emoji）、ASCII（純英文）、ISO-8859-1（西歐語言）。字元集錯誤會導致解碼後出現亂碼。Base64 轉文字工具

HTTP Basic Authentication

HTTP 協議中的一種認證方式，將使用者名稱和密碼用冒號連接後進行 Base64 編碼，放在 Authorization 請求頭中傳輸。解碼後可檢視帳號密碼明文，格式為：Authorization: Basic <base64(username:password)>。Auth Header 建構器

JWT 解碼（Base64URL）

JWT Token 由三段以 . 分隔的 Base64URL 編碼組成：header（演算法資訊）、payload（聲明資料）、signature（簽名）。解碼 JWT 通常只需處理前兩段，第三段是 HMAC 或 RSA 簽名不應解碼驗證。JWT 工具

Base64 解碼常見錯誤與解決方式

Base64 變體與解碼對應表

Authoritative References

• ReferenceRFC 4648 - The Base16, Base32, and Base64 Data Encodings
• ReferenceRFC 2045 - MIME Part One: Format of Internet Message Bodies
• ReferenceRFC 7519 - JSON Web Token (JWT)
• ReferenceMDN Web Docs - btoa()
• ReferenceMDN Web Docs - atob()
• ReferenceMDN Web Docs - DOMException
• ReferenceWikipedia - Base64