python 3 处理中文文本的 base64 编码时,先用 encode("utf-8") 得到字节,再调用 base64.b64encode(),最后转成 ascii 字符串。还原时顺序相反:严格解码 base64,再按 utf-8 解码。base64 只是编码,任何人拿到结果都能还原,不提供保密性。

把中文文本编码为 Base64 字符串
以下代码可单独保存为 encode_text.py 执行。b64encode 接受字节类对象,不能直接传入 str;它返回的也是 bytes。转换为 ASCII 字符串后,便于写入 JSON 字段或文本文件。
import base64
text = "你好,Python"
raw = text.encode("utf-8")
encoded = base64.b64encode(raw).decode("ascii")
assert encoded.isascii()
assert base64.b64decode(encoded, validate=True) == raw
print(encoded)
print(type(encoded).__name__) # str
编码结果的字符集与原文本的语言无关。空文本也能处理:空字节编码后仍为空字节,不需要另设“跳过空文本”的规则。若输入原本就是图片等二进制数据,直接编码字节,不要先把图片按 UTF-8 解码。

严格解码并区分格式错误与字符编码错误
b64decode(..., validate=True) 检查非 Base64 字符及相关格式错误,解码结果仍是 bytes。缺失必需的填充会报错,标准解码接口不会任意修复输入;不要为掩盖格式问题自动补字符。下面三种异常分别对应非 ASCII 输入、Base64 格式不正确和解码后的字节不是 UTF-8。
Camoufox 是一个基于 Firefox 构建的开源反检测浏览器,为 Python 自动化工作流程提供强大的指纹注入和反机器人检测规避功能。它与 Playwright 集成,以提供能够绕过现代机器人检测系统的隐身浏览能力。
import base64
import binascii
def decode_text(value):
try:
encoded_bytes = value.encode("ascii")
raw = base64.b64decode(encoded_bytes, validate=True)
return raw.decode("utf-8")
except UnicodeEncodeError as error:
raise ValueError("Base64 文本应只包含 ASCII 字符") from error
except binascii.Error as error:
raise ValueError("Base64 格式不正确") from error
except UnicodeDecodeError as error:
raise ValueError("还原的字节不是 UTF-8 文本") from error
assert decode_text("5L2g5aW9") == "你好"
assert decode_text("") == ""
for value in ["SGVs bG8=", "YQ", "/w==", "中文"]:
try:
decode_text(value)
except ValueError as error:
print(error)
else:
raise AssertionError("本用例应当失败")
如果传输协议允许 Base64 内有换行,需要按协议规范化后再严格校验,不能把所有无关字符都忽略。合法 Base64 不代表内容可信,也不代表还原结果一定是文本。
用往返断言检查中英文、符号与空文本
将下列内容单独保存执行,可验证编码与还原的字节约定一致。不要依赖手抄的编码结果作为唯一判断;还原后与原文相等,才是这个往返测试关注的条件。
import base64
for original in ["中文", "Hello,世界", "", "a+b/c=", "第一行\n第二行"]:
encoded = base64.b64encode(original.encode("utf-8")).decode("ascii")
restored = base64.b64decode(encoded, validate=True).decode("utf-8")
assert restored == original
print("5 组文本往返通过")
标准 Base64 的 + 和 / 在某些 URL 场景中不方便使用,可以按接口约定选择 URL 安全变体。变体不是加密,且不能把两种字母表与校验规则随意混用。
Python免费学习笔记(深入):立即使用
在学习笔记中,你将探索 Python 的核心概念和高级技巧!










