在 Python 中,先用 UTF-8 的 encode() 将字符串转成字节,再调用 base64.b64encode() 编码。还原时,先用 base64.b64decode() 取回字节,再用 UTF-8 的 decode() 恢复字符串。下面的示例展示了完整过程:
import base64
text = "你好,Python" # str
raw = text.encode("utf-8") # bytes
encoded = base64.b64encode(raw) # bytes
encoded_text = encoded.decode("ascii") # str
decoded = base64.b64decode(encoded_text) # bytes
restored = decoded.decode("utf-8") # str
print(encoded_text) # 5L2g5aW977yMUHl0aG9u
print(restored) # 你好,Python
导入标准库 base64
base64 属于 Python 标准库,无需另行安装。初学者可以先阅读标准库常用模块介绍;如果还没有配置 Python 环境,也可以从 Python 中文教程 开始。
先把字符串编码为字节
普通字符串的类型是 str,Base64 函数处理的则是字节数据。调用 text.encode("utf-8") 后,Python 会按照 UTF-8 编码规则将文本转换为 bytes。关于 UTF-8 和字符、字节之间的关系,可参阅维基百科的 UTF-8 介绍,以及 Python 字符串官方文档。
用 b64encode 编码
base64.b64encode(raw) 接收字节数据,并返回 Base64 编码后的 bytes。因此,示例中的 encoded 仍是字节,而不是普通字符串。这也是进行 base64 encode 时容易忽略的一点:编码结果若要作为文本使用,还需再转换一次。输入类型和返回值的说明见 Python 官方 Base64 文档。
将编码结果转换为文本
Base64 使用有限范围内的文本字符表示字节数据,因此可以用 ASCII 将编码结果转成 str:encoded.decode("ascii")。这一步只改变结果的类型,不会改变它所表示的数据。
用 b64decode 解码并恢复字符串
base64.b64decode(encoded_text) 返回原始字节。若原始数据是文本,再用原先采用的字符编码调用 decode()。本例使用 UTF-8,因此写作 decoded.decode("utf-8")。

完整转换路径如下:
str → UTF-8 bytes → Base64 bytes → Base64 文本 → 原始 bytes → str
调用 b64decode() 时,也可以直接传入 Base64 文本 encoded_text,不必先手动将它转成 bytes。
str 和 bytes 的区别
| 操作 | 输入类型 | 返回类型 | 用途 |
|---|---|---|---|
text.encode("utf-8") |
str |
bytes |
将文本转成字节 |
base64.b64encode(data) |
bytes |
bytes |
将字节编码为 Base64 |
encoded.decode("ascii") |
bytes |
str |
将 Base64 结果转成文本 |
base64.b64decode(value) |
Base64 文本或字节 | bytes |
还原编码前的字节 |
decoded.decode("utf-8") |
bytes |
str |
将文本字节恢复为字符串 |
如果把普通 str 直接传给 b64encode(),会遇到类型错误。应先明确指定字符编码,例如 text.encode("utf-8")。解码后若得到的仍是字节,也要按照原先使用的字符编码调用 decode()。
填充、网址安全形式和使用边界
Base64 每次处理三个字节。若末尾剩余字节不足三个字节,编码结果可能带有 = 填充。填充数量取决于剩余字节数,不是每个结果都会以 == 结尾:b"M" 编码为 b"TQ==",b"Ma" 编码为 b"TWE=",b"Man" 编码为 b"TWFu"。

Base64 编码后的文本通常比原始字节更长,因此它不是压缩方式,也不能替代加密。拿到编码结果的人可以将它解码,不要用 Base64 保护密码或敏感信息。
base64.urlsafe_b64encode() 面向网址等场景,会用 - 和 _ 替换标准 Base64 字符 + 和 /。它仍然只是编码,不提供保密或安全防护。
图片等二进制数据也可以表示为 Base64。本文不展开文件读取和转换步骤;需要了解文件操作时,可继续阅读文件读写指南。
常见问题
Base64 解码会做什么?
它将 Base64 文本还原为原始字节。如果这些字节代表文本,再按原先的字符编码调用 decode()。
Base64 一定以两个等号结尾吗?
不一定。编码结果可能没有填充、带一个 =,也可能带两个 =,具体取决于输入字节数。
Base64 会缩小数据体积吗?
不会。编码结果通常更长,常见情况下会增加约三分之一。
为什么 b64encode() 要求输入 bytes?
Base64 处理的是字节序列。字符串必须先按明确的字符编码转成字节,避免不同文本编码造成歧义。
Python 需要安装额外的 Base64 库吗?
不需要,直接导入标准库 base64 即可。更多说明可查阅 Python 官方 Base64 文档。
想继续学习 Python,可以从 Python 下载 的教程和模块指南开始。
来源
Related: uuid 生成唯一标识