Pillow：Python 图像处理的基石

Pillow：Python 图像处理的基石

Pillow 是 Python 生态中最知名的图像处理库之一，在 GitHub 上收获了 13,590 个 Star。从个人脚本到企业级 Web 应用，Pillow 几乎是 Python 开发者处理图片的首选工具。

Pillow 的历史可以追溯到 PIL。PIL 由 Fredrik Lundh 在上世纪 90 年代末创建，是 Python 最早的图像处理库，但后来长期无人维护。Jeffery 'Alex' Clark 在 2010 年前后创建了 Pillow 这个友好分支，修复了大量 Bug 并添加了对 Python 3 的支持。如今 Pillow 由社区协作维护，已成为 PIL 的正式继任者。

Pillow 的文件格式支持非常广泛。JPEG、PNG、GIF、TIFF、BMP、WebP、ICO 这些常见格式自然不在话下，它还涵盖了一些专业格式如 PSD、PCX、TGA 等。高效的内部图像表示让它在处理大尺寸图片时仍能保持不错的性能。

核心能力

Pillow 提供的图像处理能力覆盖了日常开发的绝大部分场景：

• 图像变换：缩放、旋转、翻转、裁剪、透视变换
• 颜色处理：RGB、RGBA、灰度、CMYK 等颜色空间互转，亮度对比度调整
• 滤镜与增强：模糊、锐化、边缘增强、浮雕、轮廓检测
• 像素级操作：逐像素读写、通道分离与合并、直方图均衡化
• 绘图接口：在图像上绘制文字（支持 TrueType 字体）、线条、矩形、圆弧
• 动画处理：GIF 帧读取与合成、APNG 支持
• 元数据读写：读取和修改 EXIF、IPTC、XMP 等图片元信息
• 图像合成：图层叠加、透明度混合、图像拼接

这些功能通过统一的 Image 对象暴露，API 风格一致。打开图片返回 Image 实例，在实例上调用方法完成操作，最后 save 输出。整个流程不需要理解底层像素格式的细节。

Pillow 在 Web 应用中尤其常见。Django 的 ImageField 底层依赖 Pillow 处理上传图片的缩放和格式校验。Flask 和 FastAPI 项目中，用户头像裁剪、商品图缩略图生成、验证码图片合成，几行 Pillow 代码就能完成。

快速上手

安装非常直接：

pip install Pillow

打开一张图片并缩放到指定尺寸：

from PIL import Image

img = Image.open("photo.jpg")
img.thumbnail((800, 600))
img.save("thumbnail.jpg")

添加文字水印：

from PIL import Image, ImageDraw, ImageFont

img = Image.open("photo.jpg")
draw = ImageDraw.Draw(img)
font = ImageFont.truetype("arial.ttf", 36)
draw.text((10, 10), "Watermark", font=font, fill=(255, 255, 255, 128))
img.save("watermarked.jpg")

项目质量

Pillow 在工程质量上投入了大量精力。CI 系统覆盖了 Linux、macOS、Windows 以及 MinGW 和 Docker 环境，每次提交都会触发完整的测试套件。代码覆盖率由 Codecov 持续追踪，还引入了 OSS-Fuzz 进行模糊测试以发现边界情况下的安全问题。

项目的维护获得了 Tidelift、Thanks.dev 和 GitHub Sponsors 的资金支持。OpenSSF Best Practices 徽章也反映了项目在安全最佳实践方面的投入。

Pillow 经过近二十年的演进，从 PIL 的兼容补丁成长为 Python 图像处理的基础设施。大多数 Python Web 框架的图像上传处理、数据分析库的图表渲染背后都有 Pillow 的身影。它的 API 保持了长期的向后兼容，依赖它的项目可以放心升级。

对于任何涉及图像处理的 Python 项目，Pillow 是一个扎实的起点。