base64.b64encode()仅接受bytes类型，需先用with open('img.png', 'rb') as f: data = f.read()读取文件字节，再编码并.decode('utf-8')转字符串；MIME类型须匹配实际格式（如.png→image/png），且必须写全data:image/png;base64,...前缀；大图慎用，体积膨胀约33%，无法缓存。
base64.b64encode() 不能直接处理文件对象
直接传入 open('img.png', 'rb') 给 base64.b64encode() 会报 TypeError: a bytes-like object is required, not '_io.BufferedReader'。这个函数只接受 bytes，不接受文件句柄。
正确做法是先读取文件内容：
- 用
with open('img.png', 'rb') as f: data = f.read()获取原始字节 - 再传给
base64.b64encode(data)，返回的是bytes类型 - 最后调用
.decode('utf-8')转成字符串，才能拼进 HTML 的src="data:image/png;base64,..."
注意 MIME 类型要和实际文件匹配
HTML 中 base64 图片的 src 前缀写错会导致图片不显示，浏览器不会自动识别格式。常见错误是统一写 image/jpeg，但实际是 PNG 或 WebP。
稳妥方式：
立即学习“Python免费学习笔记（深入）”；
- 根据文件扩展名判断：
.png→image/png，.jpg/.jpeg→image/jpeg，.webp→image/webp - 更严谨可用
imghdr.what()或python-magic检查真实类型（尤其当扩展名被改过） - 不要省略
charset；标准写法是data:image/png;base64,...，不是data:base64,...
大图编码后体积膨胀约 33%，慎用于生产环境
base64 编码会让二进制数据变长 —— 每 3 字节变成 4 字符，理论膨胀率 33.3%。一张 1MB 的 PNG 编码后约 1.33MB，且无法被浏览器缓存，每次 HTML 加载都得重传整个字符串。
仅建议用于：
- 极小图标（
- 离线 HTML 报告（无服务器依赖场景）
- 临时调试或原型演示
生产环境优先走静态资源路径 + HTTP 缓存，而不是塞进 HTML。
一行命令快速生成 base64 字符串（调试用）
不想写脚本时，Linux/macOS 可直接终端执行：
python3 -c "import base64; print('data:image/png;base64,' + base64.b64encode(open('logo.png','rb').read()).decode())"
Windows PowerShell 类似，但注意单双引号换位；不过要注意路径中空格和中文可能出错，正式使用仍推荐完整 Python 脚本做异常处理。
真正容易被忽略的是：HTML 中嵌入的 base64 字符串如果含换行或空格（比如手动复制时带了不可见字符），图片就会完全空白——浏览器解析失败不报错，只静默失败。务必确保字符串连续无空白。
