Base64 编码：在线将文本转为 Base64

如何把文本编码为 Base64

1. 在 输入 · 文本 框中输入或粘贴文本。页面打开时带有示例内容，按 清空 即可从头开始。
2. 输入的同时，Base64 会出现在 输出 · Base64 中。输入特别大时，可以取消勾选 实时，改为按 运行。
3. 按接收方的要求设置选项：URL 安全（- _）、不填充（=）、换行 和 字符集。默认设置（标准字母表、带填充、单行、UTF-8）适用于大多数 API。
4. 按 复制输出，或按 下载 把结果保存为 base64.txt。
5. 想验证能否还原，按 互换。它会把 Base64 移到输入框，并把工具切换为解码。

按钮下方会显示输入的字节数、输出大小和变化百分比，字段有长度限制时很有用。

Base64 编码的原理

Base64 处理的是字节，所以第一步是用某种字符集把文本转成字节（这里默认 UTF-8，除非你另选）。随后编码器每次取 3 个字节，也就是 24 位，拆成 4 个 6 位的数，再把每个数写成 64 字符字母表中的一个字符：A–Z、a–z、0–9、+ 和 /。

经典例子是文本 Man：字节 4D 61 6E 变成 TWFu。最后一组只有一两个字节时，输出用 = 补齐：Ma 变成 TWE=，M 变成 TQ==。完整的推导过程见 Base64 的工作原理，填充详解 则说明了什么时候可以省略 =。

n 个字节的输出长度总是 4 × ⌈n / 3⌉ 个字符，比输入多约 33%。Base64 大小计算器 可以算出任意大小对应的长度，Base64 的体积开销 解释了这在什么时候要紧。任何人都能还原 Base64，它什么也藏不住；往里面放机密信息之前，请先读读 编码与加密的区别。

编码选项

Unicode、Emoji 和 URL 安全输出示例

下面每个值都是用 Python 的 base64 模块生成的，与本工具的输出一致。

同一个词在不同字符集下得到不同的 Base64，是因为字节不同：é 在 UTF-8 中是两个字节（C3 A9），在 Latin-1 中是一个字节（E9）。挥手 Emoji 占 4 个 UTF-8 字节，单独编码需要 8 个字符，其中两个是填充。

字符集与无法表示的字符

UTF-8 能表示所有 Unicode 字符，所以不会丢失任何内容。列表中的其余 26 种字符集（UTF-16LE/BE、UTF-32LE、ASCII、ISO-8859 和 Windows 代码页、KOI8-R/U、CP866、Shift_JIS、EUC-JP、GBK、Big5 和 EUC-KR）是为需要它们的系统准备的。如果文本中有所选字符集没有的字符，它会被替换为 ?，并有警告提示替换了多少个字符。例如 € 在 ISO-8859-1 下编码为 Pw==，其实就是一个问号。

Windows 和 .NET 字符串以及 PowerShell 请选 UTF-16LE，原因见 UTF-16 转 Base64。如果系统必须拒绝 7 位文本以外的任何内容，请选 ASCII（ASCII 转 Base64）。

换行

普通的 Base64 是一整行，JSON、HTTP 请求头、URL 和环境变量需要的正是这种形式。电子邮件使用 76 字符一行（RFC 2045），PEM 文件使用 64 字符一行。换行选项会按该宽度插入 \n 换行符；选择 76 (MIME, CRLF) 时插入的是 CRLF。解码器（包括 本站的解码器）会跳过换行，所以换行后的输出解码出的字节不变。MIME 规则见 电子邮件中的 Base64。

常见的编码错误

• 混入了末尾换行符。 echo Hello | base64 输出 SGVsbG8K，因为 echo 会加上 \n。单独的文本 Hello 是 SGVsbG8=。请使用 printf '%s'；在这里粘贴时，也检查一下输入字节数是否符合预期。
• btoa() 遇到 Unicode 会报错。 在浏览器中，btoa("Grüße 👋") 会抛出 InvalidCharacterError，因为 btoa 只接受 Latin-1 字符。请像下面的代码片段那样，先编码成 UTF-8 字节。
• 接收方用的是另一种字符集。 你按 UTF-8 编码，对方按 Latin-1 解码，café 就会变成 café。事先约定字符集，或者在这里直接选择接收方的字符集。
• 编码了两次。 SGVsbG8= 的 Base64 是 U0dWc2JHOD0=。如果一个值解码后还是 Base64，说明流程中某一步又编码了一次。
• + 和 / 会破坏 URL。 在查询字符串中，+ 会被当成空格。请使用 URL 安全选项或 Base64URL 编码器，或者对值做百分号编码。

在 JavaScript、Python 和命令行中进行 Base64 编码

在浏览器 JavaScript 中，先用 TextEncoder 把字符串转成 UTF-8 字节，再对字节编码。较新的浏览器可以直接调用 bytes.toBase64()（Uint8Array.toBase64）。

const bytes = new TextEncoder().encode("Grüße 👋");
let bin = "";
for (const b of bytes) bin += String.fromCharCode(b);
btoa(bin);                                   // "R3LDvMOfZSDwn5GL"

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

在 Python 中，b64encode 接收字节并返回字节：

import base64

base64.b64encode("Grüße 👋".encode("utf-8")).decode("ascii")
# 'R3LDvMOfZSDwn5GL'
base64.urlsafe_b64encode("👋".encode()).rstrip(b"=").decode()
# '8J-Riw'

在 Linux 和 macOS 上，base64 命令会编码标准输入：

printf '%s' 'Grüße 👋' | base64
base64 -w 0 file.bin > file.b64

第一条命令输出 R3LDvMOfZSDwn5GL。Linux 上的 GNU base64 默认每 76 列换行，-w 0 可以关闭换行；macOS 版本除非指定，否则不换行。更多语言和边界情况：JavaScript 中的 Base64、Node.js、Python 和 PHP。

常见问题