怎样在Python中用base64对二进制图片进行编码？-Python教程-PHP中文网

必须用'rb'模式读取图片获取bytes，再传给base64.b64encode()；返回bytes需.decode('ascii')转字符串；拼data url时须按后缀补全mime类型前缀，大图应分块读取防内存溢出。

怎样在python中用base64对二进制图片进行编码？

用 `base64.b64encode()` 编码图片字节，不是字符串

直接对图片文件调用 base64.b64encode() 会报错：它只接受 bytes，不接受 str 或 Path。必须先以二进制模式读取文件，拿到原始字节流。

常见错误是写成 base64.b64encode("cat.jpg") 或 base64.b64encode(open("cat.jpg").read()) —— 前者传了字符串，后者默认文本模式读取，会因编码问题崩溃（尤其 Windows 下）。

正确做法：

用 open("cat.jpg", "rb") 打开文件（"rb" 是关键）
读取结果是 bytes，可直接喂给 base64.b64encode()
返回值仍是 bytes，若需字符串，再调用 .decode("ascii")

import base64
with open("cat.jpg", "rb") as f:
    img_bytes = f.read()
encoded = base64.b64encode(img_bytes).decode("ascii")
# encoded 是 str 类型，如 "data:image/jpeg;base64,/9j/4AAQ..." 的前半部分

生成 data URL 时要手动拼接 MIME 类型

base64.b64encode() 只负责编码，不加任何前缀。如果要把结果嵌入 HTML 的 src 属性，得自己补上 data:<mime>;base64,</mime> 头部。

MIME 类型不能硬编码成 image/jpeg —— PNG、WebP、GIF 各有不同。靠文件扩展名判断最简单可靠，但要注意大小写和映射准确性。

建议做法：

Python Use Agent

智能执行Python任务，自动生成、执行代码并反馈结果，无需额外配置，兼容旧命令。

下载

用 pathlib.Path("cat.png").suffix.lower() 获取小写后缀
查表映射：".png" → "image/png"，".jpg"/".jpeg" → "image/jpeg"，".webp" → "image/webp"
避免用 mimetypes.guess_type()，它依赖文件内容或扩展名，本地测试常返回 None

import pathlib
suffix_map = {".png": "image/png", ".jpg": "image/jpeg", ".jpeg": "image/jpeg", ".webp": "image/webp"}
p = pathlib.Path("cat.png")
mime = suffix_map.get(p.suffix.lower(), "image/octet-stream")
data_url = f"data:{mime};base64,{encoded}"

大图编码可能触发内存峰值，别一次性全读

一张 20MB 的 RAW 图片，读进内存就是 20MB bytes，再经 base64 膨胀到约 27MB —— 对内存紧张的环境（如某些嵌入式 Python 或低配容器）是实际压力。

base64.b64encode() 不支持流式输入，所以无法真正“边读边编”。但可以分块读取再合并，缓解瞬时压力：

用 io.BytesIO() 接收分块结果，避免频繁字符串拼接
每块控制在 8192 或 65536 字节，平衡 I/O 和内存占用
注意：分块不会改变最终 base64 结果，base64 编码本身是确定性的

import base64
import io
buf = io.BytesIO()
with open("big.tiff", "rb") as f:
    while chunk := f.read(65536):
        buf.write(base64.b64encode(chunk))
encoded = buf.getvalue().decode("ascii")