Base64 解码器：在线将 Base64 解码为文本

如何解码 Base64

1. 把 Base64 粘贴到 输入 · Base64 框中。换行、空格、两侧的引号和 data:...;base64, 前缀都可以保留，解码器会自动去掉它们。
2. 解码后的文本显示在 输出 · 文本 中。状态行会显示 有效的 Base64、变体（标准或 Base64URL）、解码后的字节数，以及 看起来像 一栏中检测到的内容类型。
3. 如果文本是乱码，请更换 字符集，或选择 自动检测。
4. 如果内容是 JSON，格式化 JSON 会将其缩进，方便阅读。
5. 点击 复制输出，或点击 下载 把解码后的字节保存为文件。扩展名取决于检测到的类型，所以 JSON 会保存为 decoded.json，PNG 会保存为 decoded.png。

互换 会把解码后的文本送回输入框并切换为编码模式，可以快速确认字符串能否原样往返转换。

解码器接受哪些输入

Base64 很少是干干净净送到你手上的。它可能来自邮件、按 76 个字符换行，可能来自 JSON 文件、带着引号，可能来自 URL、经过了百分号编码，也可能来自令牌、没有填充。解码器无需任何设置就能接受这些输入：

解码器对这些外包装很宽容，对其他一切都很严格：遇到字母表以外的字符时，它会停下并报错，指出该字符及其位置。有些库则会悄悄跳过坏字符，交给你一个已损坏的输出（见下面的代码部分）。

专门处理 URL 安全令牌的 Base64URL 解码器 讲解了这种字母表，Base64 与 Base64URL 的区别 则介绍了两者的差异。

解码结果是文件时

Base64 可以承载任何字节，很多 Base64 字符串其实是图片或文档。工具会把解码后数据的开头字节与已知的文件签名（magic number）进行比对，并把结果显示在 看起来像 中：PNG、JPEG、PDF、ZIP、gzip、JSON、XML 等等。对于二进制格式，它会显示可打印字符的预览，提示这是二进制数据，并给出对应工具的链接，例如 Base64 转图片 或 Base64 转 PDF。无论哪种情况，下载 都会保存原始字节。

Base64 字符串的开头，往往在解码之前就暴露了格式：

更多签名见 常见的 Base64 前缀。对于类型未知的文件，Base64 转文件 会识别格式并进行预览。

字符集：修复乱码

Base64 只保存字节，并不记录是哪种字符集把字符变成了这些字节。解码器默认使用 UTF-8，这对大多数现代数据都是正确的。如果不对，症状也很好辨认：

• 出现 � 字符，并提示“部分字节不是有效的 UTF-8”。 文本来自某种传统字符集。Y2Fm6Q== 按 UTF-8 读取是 caf�，按 ISO-8859-1 或 Windows-1252 读取是 café。z/Do4uXy 这样的俄文文本需要用 Windows-1251 才能显示为 Привет。
• 每个字母后面都有一个点或空隙。 这是 UTF-16，其中每个 ASCII 字母后面跟着一个零字节。SABlAGwAbABvAA== 在 UTF-16LE 中是 Hello（Base64 转 UTF-16）。
• 输出中出现 é、ü 或 ’。 解码本身是正确的；文本在被转成 Base64 之前就经过了双重编码：之前某个环节把 UTF-8 误当作 Latin-1 读取，又把结果重新存成了 UTF-8。Y2Fmw4PCqQ== 解码后正是 café。请在源头修复。

自动检测 会先检查字节序标记，再检查字节是否为有效的 UTF-8，然后检查 UTF-16 的零字节模式。Windows-1251、KOI8-R 这类单字节代码页在任何检测器看来都很相似，如果你知道数据来源，请手动选择。

错误提示及其含义

Base64 错误指南 更深入地分析了每种情况。如果想找出字符串中到底是哪个字符或哪处填充出了问题，请使用 Base64 校验器。

在 JavaScript、Python 和命令行中解码 Base64

atob() 返回的是每个字符对应一个字节的“二进制字符串”，所以 UTF-8 文本还需要经过 TextDecoder 这一步。atob 接受缺失的填充，但遇到 URL 安全的 - 和 _ 会抛出 InvalidCharacterError。

const s = "R3LDvMOfZSDwn5GL";
new TextDecoder().decode(Uint8Array.from(atob(s), c => c.charCodeAt(0)));
// "Grüße 👋"

// Node.js accepts both alphabets
Buffer.from(s, "base64").toString("utf8");          // "Grüße 👋"
Buffer.from("8J-Riw", "base64url").toString("utf8"); // "👋"

Python 遇到没有填充的输入会抛出 binascii.Error: Incorrect padding，所以要自己补上填充：

import base64

s = "SGVsbG8"
base64.b64decode(s + "=" * (-len(s) % 4)).decode("utf-8")
# 'Hello'
base64.b64decode("SGVs*bG8=", validate=True)
# binascii.Error: Only base64 data is allowed

如果不加 validate=True，Python 会丢弃 * 并返回 b'Hello'。Node 的 Buffer.from 也是如此，所以一个已损坏的字符串可能会在没有任何报错的情况下被解码。

在命令行中：

printf '%s' 'R3LDvMOfZSDwn5GL' | base64 -d
base64 -d message.b64 > message.bin

第一行输出 Grüße 👋。较旧的 macOS 版本中这个参数写作 -D。各语言的更多细节：JavaScript、Node.js、Python、PHP。

常见问题