Base32 编码与解码（RFC 4648）

如何把文本编码为 Base32

1. 在 输入 · 文本 中输入或粘贴文本。勾选 实时 后，每按一次键输出都会更新。
2. 在 输出 · Base32（RFC 4648） 中查看结果。取消勾选输出下方的 填充（=） 可以去掉末尾的 = 号。
3. 需要其他变体时，打开 到，选择 Base32hex、Crockford Base32 或 z-base-32。
4. 要改为解码，请在方向切换中点击 Base32（RFC 4648）→ 文本。专门的 Base32 解码器默认就是这个方向。
5. 用 复制输出 或 下载 带走结果。

默认情况下，文本按 UTF-8 转换为字节。如果需要同一段文本在其他编码（例如 Windows-1252 或 UTF-16LE）下的 Base32，请修改输入下方的 字符集。

Base32 的工作原理

Base32 每次读取输入的 5 个比特，每 5 个比特写出一个字符。5 个字节（40 比特）恰好变成 8 个字符，所以输出比输入大 60%。同样数据的 Base64 字符串只大 33%，这是 Base32 只使用大写字母和六个数字所付出的代价。

当输入长度不是 5 字节的倍数时，最后一组会用 = 补满 8 个字符。下面是 RFC 4648 的测试向量，由本工具生成：

填充不携带任何数据。解码器可以根据真实字符的个数算出字节数，所以很多格式都会去掉填充。

Base32 变体：RFC 4648、base32hex、Crockford、z-base-32

“Base32”指的是一个家族。四个成员都是每个字符 5 比特，区别在于字母表以及是否使用填充。同样五个字节 Hello 在各变体下的结果：

Base32hex 和 Crockford 看起来很像，但它们是不同的字母表：从 H 之后开始出现差异，所以 91IMOR3F 和 91JPRV3F 是同样的字节。选错字母表也能解码而不报错，只是会悄悄给你不同的字节。

这里的 Crockford 解码器按 Crockford 的本意做了容错：它把 I 和 L 读作 1，把 O 读作 0，并跳过连字符，所以 91JP-RV3F 仍然得到 Hello。它不会添加或校验 Crockford 可选的校验符号。

用于 TOTP 和 2FA 密钥的 Base32

身份验证器应用从 otpauth:// 链接中获取密钥，这个链接通常以二维码的形式显示：

otpauth://totp/Example:alice@example.com?secret=JBSWY3DPEHPK3PXP&issuer=Example

secret 参数是不带填充的 RFC 4648 Base32。JBSWY3DPEHPK3PXP 有 16 个字符，所以包含 10 个字节。RFC 4226 推荐使用 160 位（20 字节）的密钥，对应 32 个 Base32 字符。如果你的密钥以 Base64 或 hex 形式存储，请用 Base64 转 Base32 转换。把 Base64 文本输入到这个页面，编码的是这些字符本身，得到的 Base32 虽然有效，字节却是错的，用它生成的每个验证码都会被拒绝。

TOTP 密钥就是一把钥匙：任何拿到它的人都能生成你的验证码。本页面在你的浏览器标签页内处理密钥，页面的内容安全策略会阻止它发起除 Cloudflare 的浏览量统计以外的网络请求。

在命令行和 Python 中使用 Base32

GNU coreutils 提供了一个用法与 base64 相同的 base32 命令：

printf 'Hello' | base32
printf 'JBSWY3DP' | base32 -d

第一行输出 JBSWY3DP，第二行输出 Hello。Python 标准库包含全部三种 RFC 4648 形式：

import base64

base64.b32encode(b"Hello")                          # b'JBSWY3DP'
base64.b32hexencode(b"Hello")                       # b'91IMOR3F'
base64.b32encode(b"Hi").decode().rstrip("=")        # 'JBUQ'

更多编码写法见 Python 页面。关于解码，包括 Python 抛出的填充错误和小写错误，见 Base32 解码器。

常见问题