base64.b64encode()只接受bytes类型输入，需用'rb'模式读取文件；编码结果为bytes，转字符串需decode('utf-8')；嵌入HTML须拼接data:image/png;base64,前缀；大图需限制大小防OOM；禁用encodebytes()避免换行符导致解析失败。
base64.b64encode() 接收 bytes，不是 str
直接传入字符串（比如用 open('img.jpg').read()）会报 TypeError: a bytes-like object is required, not 'str'。Python 3 中文件默认以文本模式打开，读出来的是 str，而 base64.b64encode() 只接受 bytes。
正确做法是用二进制模式打开文件，或对已加载的 bytes 数据调用：
with open('photo.png', 'rb') as f: data = f.read()-
encoded = base64.b64encode(data)—— 返回bytes类型，如b'AAABAA==' - 若需字符串形式（比如嵌入 HTML 的
src），再解码：encoded.decode('utf-8')
编码后字符串要加 Data URL 前缀才能在 HTML 中直接显示
仅靠 base64.b64encode().decode() 得到的是一串纯 Base64 字符，浏览器无法识别为图片。必须拼接 MIME type 前缀，格式为 data:<mime>;base64,<payload>。
常见图片类型对应关系：
立即学习“Python免费学习笔记（深入）”；
- JPEG →
data:image/jpeg;base64, - PNG →
data:image/png;base64, - GIF →
data:image/gif;base64,
示例：'data:image/png;base64,' + base64.b64encode(img_bytes).decode('utf-8')
大图编码可能触发内存或性能问题
base64.b64encode() 会把原始二进制数据整体载入内存并生成等长（约 +33%）的 Base64 字符串。一张 10MB 的 PNG 编码后约产生 13.3MB 的字符串，在内存受限环境（如某些云函数、嵌入式 Python）容易 OOM。
规避方式：
- 先检查文件大小：
os.path.getsize(path) < 2 * 1024 * 1024（限制 2MB） - 不直接用于前端大图展示，改用服务端提供真实 URL
- 避免在循环中反复编码同一张图 —— 缓存结果，复用
str形式
别忽略换行和填充字符的兼容性细节
base64.b64encode() 默认不添加换行符，输出是紧凑的单行字符串，符合 Data URL 规范。但如果你误用了 base64.encodebytes()（带换行），就会在字符串中插入 \n，导致浏览器解析失败，错误表现为图片空白且控制台报 Failed to load resource。
确认方法：打印前检查是否含 \n —— encoded_bytes.find(b'\n') == -1 应为 True；encodebytes() 输出一定含换行，不能用于 Data URL。
另外，Base64 标准要求末尾填充 =，b64encode() 自动处理，无需手动补 —— 手动加反而可能出错。
