Python中的Base64编解码详解（零基础学会使用base64库进行数据编码与解码）

什么是Base64？

Base64 是一种将任意二进制数据编码为 ASCII 字符串的编码方式。它使用 64 个可打印字符（A-Z、a-z、0-9、+、/）来表示数据，末尾可能用 = 填充以保证长度是4的倍数。

常见用途包括：

• 在 HTML 中嵌入图片（Data URL）
• 在 JSON 或 XML 中传输二进制文件（如图片、PDF）
• HTTP Basic 认证中的用户名和密码传输
• 加密前的数据预处理

Python base64库基本用法

Python 的 base64 模块提供了多种函数用于编码和解码。最常用的是 b64encode() 和 b64decode()。

1. 对字符串进行Base64编码

注意：Base64 编码操作的是 字节（bytes），不是字符串（str）。因此需要先将字符串转为字节。

import base64# 原始字符串text = "Hello, Python base64编码!"# 将字符串转为字节（使用UTF-8编码）text_bytes = text.encode('utf-8')# Base64编码encoded = base64.b64encode(text_bytes)# 输出结果（bytes类型，可转为字符串显示）print("编码结果:", encoded.decode('utf-8'))

运行结果：

SQ==

2. 对Base64字符串进行解码

import base64# Base64编码后的字符串encoded_str = "SGVsbG8sIFB5dGhvbiBiYXNlNjTnlKjvvIUh"# 将字符串转为字节encoded_bytes = encoded_str.encode('utf-8')# Base64解码decoded_bytes = base64.b64decode(encoded_bytes)# 转回原始字符串decoded_text = decoded_bytes.decode('utf-8')print("解码结果:", decoded_text)

实用技巧与注意事项

• 始终处理字节：base64 函数只接受 bytes 类型，不要直接传入 str。
• 编码格式一致：编码和解码时应使用相同的字符编码（通常为 UTF-8）。
• URL安全变体：如果用于 URL，可使用 base64.urlsafe_b64encode()，它会把 + 和 / 替换为 - 和 _。
• 填充字符：Base64 字符串末尾的 = 是填充符，解码时不能省略（除非使用特殊参数）。

完整示例：文件Base64编码

你也可以对图片、PDF 等二进制文件进行 Base64 编码：

import base64# 读取图片文件（以二进制模式）with open('example.jpg', 'rb') as f:    image_data = f.read()# 编码为Base64image_b64 = base64.b64encode(image_data).decode('utf-8')# 保存到文本文件或用于网页with open('image_base64.txt', 'w') as f:    f.write(image_b64)print("图片已成功编码为Base64字符串！")

总结

通过本教程，你已经掌握了 Python base64编码 和 base64解码教程 的核心知识。无论是处理普通文本还是二进制文件，base64 库都能帮你轻松完成任务。

记住关键点：先转字节，再编码；先解码，再转字符串。掌握这些，你就能在 Web 开发、API 调用、数据存储等场景中灵活运用 Base64 技术了。

希望这篇 Python Base64库使用 教程对你有帮助！如果你正在处理 base64字符串转换 相关的问题，不妨动手试试上面的代码吧！