编码/解码

Base64 编解码

对文本进行 Base64 编码或解码

原始文本
Base64
结果将显示在这里

什么是 Base64 编码?

Base64 是一种基于 64 个可打印字符来表示二进制数据的编码方式。它常用于在文本协议(如 HTTP、电子邮件)中传输二进制数据,或在 URL 和 HTML 中嵌入小型数据(如图片的 Data URI)。

功能特点

  • 双向转换:支持编码和解码两种模式
  • 中文支持:正确处理 UTF-8 编码的中文字符
  • 实时转换:输入即时得到结果
  • 一键复制:快速复制转换结果

使用场景

  • 图片转 Data URI:将小图片转换为可内嵌的 Base64 字符串
  • API 认证:HTTP Basic Auth 使用 Base64 编码凭证
  • 数据传输:在 JSON 中传输二进制数据
  • 邮件附件:电子邮件附件的编码方式

Base64 把每 3 个字节映射为 4 个可打印 ASCII 字符,使二进制数据能通过只支持文本的通道传输。本工具在浏览器内对 UTF-8 文本进行编码与解码,中文字符同样适用。

编码是怎么算出来的

每 3 个字节(24 位)被切成 4 个 6 位值,每个值在 A–Z、a–z、0–9、+、/ 共 64 个字符的字母表中取字符。若输入长度不是 3 的倍数,编码器补零位并追加 = 或 ==,使输出长度始终是 4 的倍数。这个填充是结构性的、不属于数据本身,解码器必须容忍它;而严格的实现会拒绝长度不是 4 的倍数的载荷。

为什么中文要先转 UTF-8

Base64 作用于字节而不是字符。一个汉字在 UTF-8 中占 3 个字节,因此 世界 是 6 字节,编码后得到 8 个 Base64 字符。浏览器的 btoa() 遇到码点大于 0xFF 的字符会直接抛错,可靠做法是先用 TextEncoder 取 UTF-8 字节、逐个转成字节串再 btoa();解码则用 TextDecoder 还原。漏掉这一步是中文输入报「无效字符」或出现乱码的最常见原因。

Base64 与 Base64URL 的区别

URL 安全变体把 + 换成 -、/ 换成 _,并且通常去掉尾部填充,因为 + 在查询串中会被解析成空格、/ 会改变路径层级。JWT 的各段、大量 API token 与 JWK 都使用 Base64URL。若标准 Base64 的输出含 + 或 /,直接拼进 URL 就会出错,使用前先确认消费方期望哪种字母表。

实操示例

中英混排文本的编码

输入
hello 世界
输出
aGVsbG8g5LiW55WM

输入在 UTF-8 下是 10 个字节(5 个 ASCII 字节、1 个空格、2 个三字节汉字),共 12 字节可被 3 整除,因此上面 20 个字符的输出没有 = 填充。把结果粘贴回解码模式即可逐字节还原原文。

边界与常见误用

  • 体积会膨胀约 33%(每 3 字节变 4 字符),大载荷和 CSS 内嵌 Data URI 要特别注意。
  • 它是编码而非加密,任何人都能解开,不能用来保护密码或密钥。
  • 文本解码要求输入是合法 UTF-8;二进制内容应作为文件处理,而不是当作字符串。
  • 严格实现不接受载荷中的换行与空白,解码前需先清除。

相关工具

用这个 Base64 工具,还是用旁边那个

情形这个 Base64 工具该换谁
要处理的是 PNG、PDF 或压缩包解码后会把字节当成 UTF-8 文本校验,所以一段语法完全正确的二进制 Base64 仍然只得到「无效的 Base64 字符串」。文件 Base64 转换工具,它按字节缓冲区读取文件。只要载荷不是合法 UTF-8 文本,就该换成它。
结果要塞进 URL、JWT 或对象键名输出保留标准字母表,+ 和 / 会原样留下,拼进查询串或路径就会出错。改用 Base64URL,例如 Buffer.from(text, "utf8").toString("base64url")。消费方是 URL、JWT 或 JWK 时不要用本工具的输出去硬拼。
怀疑某个字节错了,想定位它每 3 个输入字节压成一个 4 字符块,错误只在本块内平移字符,两段载荷看起来几乎没有差别。Hex 工具会打印字节偏移。要对比两段载荷时用它,只是搬运一段值时再用本工具。
同样的转换要跑几十个文件或进 CI每次在标签页里粘贴一次,没有可脚本化的入口,也没有转换记录。base64 命令或 python3 -m base64 负责批量;本页留给单个值的肉眼核对。
内容以 ASCII 为主,只是要放进查询参数3 个字节变 4 个字符,产出的 +、/、= 还得再套一层百分号编码。URL 编解码工具直接对 UTF-8 字节做百分号编码,长度更短,调请求时也看得懂。
解出来的东西是 JSON 或 XML,得看懂结构只给一串纯文本,从中途断掉的片段和完整载荷看不出差别。在本页解出文本,再粘进 JSON 格式化工具。多这一次粘贴,才看得出载荷是不是被截断。

一个具体场景

从工单里捞出一段 JWT payload

工单里贴来的是 token 中间那一段:74 个字符,结尾没有等号,中间还夹着一个 -。这 74 个字符是 55 字节内容的 Base64URL 形式,按 4 × ceil(55 / 3) = 76 算,正好被剥掉了两个填充位。直接粘进解码框只会得到「无效的 Base64 字符串」,因为 atob 的字母表里没有 -:先把 -、_ 换回 +、/,再补上 == 让长度回到 4 的倍数,Python 这类严格的解码器也才肯收。若某段长度除以 4 余 1,补多少等号都救不回来,那是复制时被截断了,只能回去取原始日志。解出的通常是 JSON,转手丢进 JSON 格式化工具确认没断,再判断这段 token 到底有没有问题。

常见问题

为什么 Base64 结果结尾有一个或两个 "=" 号?
这是填充符,用于把编码结果补齐到 4 的倍数。Base64 把 3 字节编码为 4 字符:剩 1 字节补 "==",剩 2 字节补 "="。填充不携带数据,部分 URL 安全变体会直接省略它。
Base64 是加密吗?
不是。Base64 是无密钥的可逆编码,任何人都能解码。它适合把二进制数据以文本形式传输,不能用来保护机密内容——需要保密应该用 AES 等加密算法。
为什么中文在某些工具里解码出来是乱码?
经典的 atob/btoa 只支持 Latin-1 字节。本工具按 UTF-8 字节编码你的文本,因此中文、emoji 等非 ASCII 字符可以正确往返转换。

内容复核: