imageio：一个 Python 库搞定所有图像视频读写

imageio：一个 Python 库搞定所有图像视频读写

imageio 是一个成熟的 Python 图像与视频读写库，在 GitHub 上获得了 1,699 Stars。

做图像处理的 Python 开发者都经历过这个场景：不同的图像格式需要不同的库，JPEG 用 Pillow，TIFF 用 tifffile，视频还得上 OpenCV 或 FFmpeg 绑定。每个库的 API 各不相同，切换格式就意味着重写代码。

imageio 用一个统一接口解决了这个问题。它支持超过 295 种图像和视频格式，包括动画图像、体积数据和科学计算格式。跨平台，Python 3.10 以上就能跑。

五个函数搞定大部分场景

imageio 的 API 设计很克制，核心函数一只手数得过来：

importimageio.v3asiio im=iio.imread('imageio:chelsea.png')# 读取图像im.shape# im 是 NumPy 数组 (300, 451, 3)iio.imwrite('chelsea.jpg',im)# 转存为 jpg

除了imread()和imwrite()，还有四个常用函数：

• imiter()用于迭代图像序列，处理动图、视频、OME-TIFF 等时序数据
• improps()获取标准化元数据，不同格式返回统一结构的属性
• immeta()获取格式专属元数据，保留各格式的原生信息
• imopen()提供更细粒度的控制，适合需要逐帧写入或流式处理的场景

所有函数返回的都是 NumPy 数组，可以直接接入现有的 NumPy、SciPy 或 OpenCV 工作流，没有额外的数据转换开销。

两个核心依赖，可选插件按需加载

imageio 的核心依赖只有 NumPy 和 Pillow。视频处理需要额外安装imageio-ffmpeg或pyav，TIFF 支持需要tifffile，FITS 格式需要astropy，ITK 格式需要itk或SimpleITK。这些可选依赖按需安装，不会污染基础环境。

安装方式很简单：

pip install imageio

或者用 Conda：

conda install imageio

插件机制：一个入口，多个后端

imageio 的架构分三层：用户 API、插件管理器、后端插件。

调用imread()时，插件管理器根据文件扩展名和资源类型自动选择合适后端。用户不需要知道某个格式对应哪个库，imageio 替你做了这个判断。

比如读取 TIFF 文件，插件管理器会优先使用 tifffile（如果已安装），否则回退到 Pillow。视频格式同理，会依次尝试 pyav 和 imageio-ffmpeg，直到找到可用的后端。

这种设计带来的实际收益是：业务代码只依赖 imageio 的 API，后端切换不影响上层逻辑。某天某个后端有性能问题想换掉，改一个参数就行。

支持多种数据源

imageio 不只是读本地文件。支持的输入源覆盖了常见的场景：

• 本地文件路径
• HTTP/HTTPS URL，远程图片直接读取
• 字节数据（bytes），内存中的图像流不用先写磁盘
• 类文件对象（file-like objects）
• 内置imageio:协议，可以直接读取标准测试图像

从网络下载图片做处理，或者从数据库里读出的 BLOB 数据，都不需要额外中转步骤。

典型应用场景

批量格式转换：几百张图片从 PNG 转 WebP，几行代码循环处理即可，比打开 PhotoShop 快得多。

视频帧提取：用imiter()逐帧读取视频，做关键帧分析或预处理。视频文件当作图像序列来遍历，逻辑统一。

科学数据可视化：支持 FITS、DICOM 等科学格式，天文学和医学影像领域的常用格式都有覆盖。

深度学习数据管道：返回 NumPy 数组的特性让它能无缝接入 PyTorch 或 TensorFlow 的 DataLoader。自定义 Dataset 类时，imread()一行就能完成图像加载。

imageio 是一个经过时间检验的项目，代码质量高，测试覆盖全面，包含功能测试、回归测试和集成测试。文档在 Read the Docs 上维护，从入门指南到 API 参考再到插件开发，体系完整。

如果你在 Python 项目中有图像或视频读写的需求，imageio 值得一试。统一的 API 加上广泛的格式支持，能帮你省下大量适配不同格式的时间。

系完整。

如果你在 Python 项目中有图像或视频读写的需求，imageio 值得一试。统一的 API 加上广泛的格式支持，能帮你省下大量适配不同格式的时间。