本文深入解析了Python中图片与Base64互转的核心要点与实战陷阱：从必须使用二进制模式（"rb"/"wb"）读写、正确处理padding缺失和data URL前缀，到规避大图一次性加载导致的内存爆炸，再到揭示Web端使用Base64图片的真实代价——无法CDN缓存、懒加载失效、调试困难等硬伤；既厘清了常见TypeError根源（如误传路径或PIL对象），也提供了安全编码、鲁棒解码及性能优化的可落地方案，帮你避开90%的生产环境坑。

用 base64.b64encode() 编码图片文件必须读成 bytes

直接传入文件路径或字符串会报 TypeError: a bytes-like object is required, not 'str'。Python 的 base64.b64encode() 只接受 bytes，不接受文本或路径。

正确做法是用二进制模式打开图片，再传给编码函数：

import base64
with open("photo.jpg", "rb") as f:
img_bytes = f.read()
encoded = base64.b64encode(img_bytes).decode("utf-8")
得到的 encoded 是字符串，可用于 HTML src 或 API 提交

• 必须用 "rb" 模式打开，"r" 会解码为 str，触发类型错误
• .decode("utf-8") 是为了把编码结果从 bytes 转成常用字符串；若需保留 bytes（比如写入二进制文件），可省略这步
• 常见误操作：对 PIL.Image 对象直接调用 b64encode() —— 它不是 bytes，得先用 .tobytes() 或保存到 BytesIO

用 base64.b64decode() 还原图片要补全 padding 并写入 binary 文件

Base64 字符串末尾的 = 是 padding，缺失时 b64decode() 会抛 binascii.Error: Incorrect padding。尤其从 URL、HTML 属性或某些 API 返回的 Base64 常被截断或省略 padding。

安全解码需手动补全：

import base64
encoded_str = "iVBORw0KGgoAAAANSUhEUgAA..."  # 可能缺 = 的字符串
补齐长度为 4 的倍数
missing_padding = len(encoded_str) % 4
if missing_padding:
encoded_str += "=" * (4 - missing_padding)
img_bytes = base64.b64decode(encoded_str)
with open("restored.png", "wb") as f:
f.write(img_bytes)

• 只靠 try/except 捕获再重试不够鲁棒；padding 规则固定，主动补更可靠
• 写入必须用 "wb"，用 "w" 会因编码问题损坏图片
• 如果 Base64 前缀含 data:image/png;base64,，得先用 .split(",", 1)[1] 切掉前缀，否则解码失败

大图编码别用 read() 一次性加载，内存会爆

一张 20MB 的 PNG 图片，经 Base64 编码后体积增大约 33%，且 Python 会同时在内存中存原始 bytes 和编码后字符串——实际占用超 50MB。对批量处理或服务端场景很危险。

• 小图（f.read() 最简单
• 中大图（>2MB）：改用 base64.encodebytes()，它支持分块读取并自动换行（虽然你通常不需要换行，但它的实现内部做了流式处理）
• 真正大图或不确定大小：用 io.BytesIO + 分块读取 + 手动 feed 给 b64encode，但多数情况没必要——优先考虑是否真需要 Base64，还是该传 URL 或二进制流

Web 场景下 Base64 图片的 real-world 限制

浏览器支持没问题，但实际用起来有几个硬伤：

• 无法被 CDN 缓存：Base64 是内联数据，每次 HTML 加载都重复传输，没复用
• HTTP/2 推送和 preload 不适用：浏览器不识别 data URL 为独立资源
• 图片懒加载（loading="lazy"）失效：data URL 立即解析，失去延迟加载意义
• 调试困难：Chrome DevTools 的 Network 面板里看不到 Base64 图片的尺寸、类型、加载时间，只有 HTML 文本长度

除非是极小图标（。

文中关于的知识介绍，希望对你的学习有所帮助！若是受益匪浅，那就动动鼠标收藏这篇《Python图片转Base64方法详解》文章吧，也可关注golang学习网公众号了解相关技术文章。