Python base64 编码解码:b64encode 用法教程

Released: 2026年11月14日
📅 最后更新:2026年11月16日

在 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")。

图示展示从字符串到 UTF-8 字节、Base64 字节和 Base64 文本,再还原为原始字节与字符串的五步过程。

完整转换路径如下:

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 生成唯一标识

Related Resources