Python的base64模块只接受bytes类型输入，传入str会报TypeError；编码需先用.encode('utf-8')转bytes，结果再.decode('ascii')得字符串；解码前须补全padding并确保输入为干净ASCII，解码后bytes需按原编码显式.decode()。
Python 的 base64 模块能直接处理字节数据，但如果你传入字符串（str）会报 TypeError: a bytes-like object is required, not 'str' —— 这是新手踩得最多的坑。
编码前必须先 encode 成 bytes
Python 3 中 base64.b64encode() 只接受 bytes，不能直接传字符串。常见错误是写 base64.b64encode("hello")，结果崩掉。
- 正确做法：先用
.encode('utf-8')转成 bytes，再编码：base64.b64encode("hello".encode('utf-8')) - 返回值是
bytes类型，如果需要字符串形式，得再调用.decode('ascii') - 别用
.encode('utf-8').decode('utf-8')绕弯子 —— 编码后不能直接 decode('utf-8')，因为 base64 输出只含 ASCII 字符，应 decode('ascii')
解码时要小心 padding 和字符集
base64.b64decode() 对输入敏感：缺失填充符 =、混入空格或换行、用了非 ASCII 编码都可能触发 binascii.Error: Incorrect padding 或 UnicodeDecodeError。
- 确保输入是干净的 ASCII 字符串（或 bytes），不含不可见控制符
- 如果从 URL 或文件读取，先用
.strip()去首尾空白，再检查是否满足长度 % 4 == 0；不够就补=（最多补两个） - 解码后得到 bytes，若原内容是文本，需显式
.decode('utf-8')；如果是二进制（如图片），就别 decode
处理非 ASCII 字符或中文时容易乱码
中文本身不是问题，问题出在编码链路断在某一步。比如把中文字符串 encode 成 gbk 再 base64，却用 utf-8 解码回来，必然出错。
立即学习“Python免费学习笔记（深入）”；
- 统一用
utf-8—— 这是事实标准，除非对接遗留系统明确要求 gbk - 不要依赖默认编码：显式写
"你好".encode('utf-8')，而不是"你好".encode()（后者在某些环境可能用 locale 编码） - 如果 base64 字符串来自前端 JS 的
btoa()，注意它按 UTF-16 编码，Python 端需先转成 UTF-16 bytes 再 decode，不能直 decode('utf-8')
真正麻烦的不是函数调用本身，而是编码路径上任意一环没对齐 —— 字符串 → bytes → base64 → bytes → 字符串，每步的编码协议必须一致，漏看一个 .encode() 或错用一个 decode 参数，结果就不可逆了。
