1. 为什么选择Pillow处理图像如果你经常需要处理图片比如批量调整尺寸、添加水印或者制作缩略图Pillow绝对是Python开发者的首选工具。我第一次接触Pillow是在做一个电商项目需要自动生成上千张商品缩略图手动操作简直要命。Pillow只用几行代码就搞定了这个需求从此我就爱上了这个库。Pillow是Python Imaging LibraryPIL的现代分支相比原版PIL它支持Python 3.x更新更活跃功能也更强大。它能处理几乎所有常见图片格式从JPEG、PNG到GIF、BMP都不在话下。最让我惊喜的是它的API设计非常人性化很多复杂操作都能用简单的方法调用实现。2. 快速安装与环境配置2.1 安装Pillow的正确姿势安装Pillow非常简单但有些细节不注意可能会踩坑。我建议直接用pip安装pip install Pillow这里有个小技巧如果你同时安装了多个Python版本记得确认pip对应的是你要用的Python版本。我曾经因为用错了pip导致安装后import失败排查了半天才发现问题。验证安装是否成功可以运行import PIL print(PIL.__version__)如果看到版本号输出比如9.5.0说明安装成功。如果报错可能是环境变量没配置好或者有多个Python版本冲突。2.2 解决常见的安装问题在实际项目中我遇到过几个典型的安装问题。首先是权限问题在Linux系统上可能需要加sudosudo pip install Pillow其次是依赖缺失的问题特别是处理JPEG图片时可能会报错。这是因为Pillow需要系统级的libjpeg库支持。在Ubuntu上可以这样解决sudo apt-get install libjpeg-dev libpng-devWindows用户如果遇到类似问题可以考虑安装预编译的Pillow wheel文件或者使用Anaconda这样的科学计算发行版它们通常已经包含了所有必要的依赖。3. 图像处理基础操作3.1 打开和查看图像Pillow处理图像的第一步当然是打开图片文件。基本操作很简单from PIL import Image img Image.open(example.jpg) img.show()但这里有几个实用技巧文件路径可以是相对路径或绝对路径如果图片很大show()方法可能会很慢可以考虑先用thumbnail()缩小尺寸处理完记得关闭文件或者使用with语句自动管理我习惯用下面这种方式可以避免忘记关闭文件with Image.open(example.jpg) as img: # 处理图片 pass3.2 获取和修改图像属性了解图像的基本信息对后续处理很重要。Pillow提供了几个常用属性print(img.format) # 图像格式如JPEG、PNG print(img.size) # 图像尺寸如(800, 600) print(img.mode) # 颜色模式如RGB、L(灰度)修改这些属性也很简单。比如要改变图像大小new_size (400, 300) resized_img img.resize(new_size)但要注意resize()方法不会改变原图而是返回一个新的Image对象。这个设计避免了意外修改原图非常贴心。4. 图像编辑进阶技巧4.1 裁剪、旋转和翻转裁剪是常见的图像操作。Pillow的crop()方法接受一个四元组(left, upper, right, lower)box (100, 100, 400, 400) # 定义裁剪区域 cropped_img img.crop(box)旋转图像也很简单rotated_img img.rotate(45) # 顺时针旋转45度如果想水平或垂直翻转flipped_img img.transpose(Image.FLIP_LEFT_RIGHT) # 水平翻转 flipped_img img.transpose(Image.FLIP_TOP_BOTTOM) # 垂直翻转4.2 颜色模式转换不同的应用场景需要不同的颜色模式。Pillow支持多种模式转换gray_img img.convert(L) # 转为灰度图 rgba_img img.convert(RGBA) # 转为带透明通道的图像我在处理证件照时经常需要把背景变成透明这时候RGBA模式就派上用场了。配合像素级操作可以实现很多高级效果。5. 添加文字和图形5.1 在图像上绘制文字Pillow的ImageDraw模块让添加文字变得简单from PIL import ImageDraw, ImageFont draw ImageDraw.Draw(img) draw.text((10, 10), Hello Pillow, fillred)但处理中文时可能会遇到乱码问题。这是因为默认字体不支持中文。解决方法是指定中文字体font ImageFont.truetype(simhei.ttf, 24) draw.text((10, 10), 你好Pillow, fontfont, fillblack)5.2 绘制几何图形除了文字ImageDraw还支持各种几何图形# 画矩形 draw.rectangle([(50, 50), (150, 150)], outlinered, width2) # 画线 draw.line([(0, 0), (100, 100)], fillblue, width3) # 画圆 draw.ellipse([(200, 200), (300, 300)], outlinegreen, width2)这些功能在做图片标注或者生成简单图表时特别有用。6. 滤镜和图像增强6.1 内置滤镜效果Pillow提供了一系列内置滤镜通过ImageFilter模块调用from PIL import ImageFilter blurred img.filter(ImageFilter.BLUR) # 模糊效果 contour img.filter(ImageFilter.CONTOUR) # 轮廓效果 detail img.filter(ImageFilter.DETAIL) # 细节增强我经常用高斯模糊来做背景虚化效果blurred img.filter(ImageFilter.GaussianBlur(radius5))6.2 自定义滤镜除了内置滤镜你还可以创建自定义滤镜。比如实现一个简单的边缘检测from PIL import ImageFilter class MyFilter(ImageFilter.BuiltinFilter): name MyEdgeDetect filterargs ((3, 3), 1, 0, ( -1, -1, -1, -1, 8, -1, -1, -1, -1, )) custom_filtered img.filter(MyFilter)这种灵活性让Pillow可以应对各种特殊需求。7. 批量处理图像7.1 自动化处理大量图片Pillow真正的威力在于批量处理。假设你有一个文件夹的图片需要生成缩略图import os from PIL import Image input_dir originals output_dir thumbnails os.makedirs(output_dir, exist_okTrue) for filename in os.listdir(input_dir): if filename.lower().endswith((.jpg, .png)): with Image.open(os.path.join(input_dir, filename)) as img: img.thumbnail((300, 300)) img.save(os.path.join(output_dir, filename))这段代码会保持图片的宽高比将长边缩放到300像素。我在电商项目中就用类似的代码处理了上万张商品图片。7.2 多线程加速处理当图片数量很多时可以考虑用多线程加速from concurrent.futures import ThreadPoolExecutor def process_image(filename): if filename.lower().endswith((.jpg, .png)): with Image.open(os.path.join(input_dir, filename)) as img: img.thumbnail((300, 300)) img.save(os.path.join(output_dir, filename)) with ThreadPoolExecutor(max_workers4) as executor: executor.map(process_image, os.listdir(input_dir))在我的测试中4线程处理1000张图片比单线程快3倍左右。但要注意线程数不是越多越好太多线程反而会因为GIL锁导致性能下降。8. 高级应用与性能优化8.1 内存优化技巧处理大图时内存消耗可能成为问题。Pillow提供了一些优化方法# 按需加载大图 Image.MAX_IMAGE_PIXELS None # 解除大图限制 img Image.open(huge_image.tif) # 分块处理 for y in range(0, img.height, 256): box (0, y, img.width, y256) region img.crop(box) # 处理这个区域我曾经用这种方法处理过单张超过1GB的卫星图像效果很好。8.2 与其他库的集成Pillow可以很好地与NumPy等科学计算库配合使用import numpy as np from PIL import Image # 将Pillow图像转为NumPy数组 array np.array(img) # 对数组进行处理后转回图像 processed_img Image.fromarray(array)这种集成让Pillow可以借助NumPy的强大计算能力实现更复杂的图像处理算法。9. 实战项目制作图片水印工具9.1 设计水印功能让我们用Pillow实现一个实用的图片水印工具。主要功能包括在图片指定位置添加文字水印支持调整水印透明度批量处理整个文件夹的图片核心代码如下from PIL import Image, ImageDraw, ImageFont, ImageEnhance def add_watermark(input_path, output_path, text, position(10, 10), font_size24, opacity0.7, color(255, 255, 255)): with Image.open(input_path) as base_img: # 创建透明层用于水印 watermark Image.new(RGBA, base_img.size, (0, 0, 0, 0)) draw ImageDraw.Draw(watermark) # 设置字体 try: font ImageFont.truetype(arial.ttf, font_size) except: font ImageFont.load_default() # 绘制水印文字 draw.text(position, text, fontfont, fillcolor (int(255 * opacity),)) # 合并图片和水印 watermarked Image.alpha_composite( base_img.convert(RGBA), watermark ).convert(RGB) watermarked.save(output_path)9.2 批量添加水印扩展上面的函数支持批量处理import os def batch_watermark(input_dir, output_dir, text, **kwargs): os.makedirs(output_dir, exist_okTrue) for filename in os.listdir(input_dir): if filename.lower().endswith((.jpg, .png, .jpeg)): input_path os.path.join(input_dir, filename) output_path os.path.join(output_dir, filename) add_watermark(input_path, output_path, text, **kwargs)这个工具我已经在实际工作中使用了很久效果非常稳定。你可以根据需要扩展更多功能比如支持图片水印、多行文字、自动调整位置等。
Pillow 图像处理实战：从安装到高级应用
发布时间：2026/7/15 19:39:20
1. 为什么选择Pillow处理图像如果你经常需要处理图片比如批量调整尺寸、添加水印或者制作缩略图Pillow绝对是Python开发者的首选工具。我第一次接触Pillow是在做一个电商项目需要自动生成上千张商品缩略图手动操作简直要命。Pillow只用几行代码就搞定了这个需求从此我就爱上了这个库。Pillow是Python Imaging LibraryPIL的现代分支相比原版PIL它支持Python 3.x更新更活跃功能也更强大。它能处理几乎所有常见图片格式从JPEG、PNG到GIF、BMP都不在话下。最让我惊喜的是它的API设计非常人性化很多复杂操作都能用简单的方法调用实现。2. 快速安装与环境配置2.1 安装Pillow的正确姿势安装Pillow非常简单但有些细节不注意可能会踩坑。我建议直接用pip安装pip install Pillow这里有个小技巧如果你同时安装了多个Python版本记得确认pip对应的是你要用的Python版本。我曾经因为用错了pip导致安装后import失败排查了半天才发现问题。验证安装是否成功可以运行import PIL print(PIL.__version__)如果看到版本号输出比如9.5.0说明安装成功。如果报错可能是环境变量没配置好或者有多个Python版本冲突。2.2 解决常见的安装问题在实际项目中我遇到过几个典型的安装问题。首先是权限问题在Linux系统上可能需要加sudosudo pip install Pillow其次是依赖缺失的问题特别是处理JPEG图片时可能会报错。这是因为Pillow需要系统级的libjpeg库支持。在Ubuntu上可以这样解决sudo apt-get install libjpeg-dev libpng-devWindows用户如果遇到类似问题可以考虑安装预编译的Pillow wheel文件或者使用Anaconda这样的科学计算发行版它们通常已经包含了所有必要的依赖。3. 图像处理基础操作3.1 打开和查看图像Pillow处理图像的第一步当然是打开图片文件。基本操作很简单from PIL import Image img Image.open(example.jpg) img.show()但这里有几个实用技巧文件路径可以是相对路径或绝对路径如果图片很大show()方法可能会很慢可以考虑先用thumbnail()缩小尺寸处理完记得关闭文件或者使用with语句自动管理我习惯用下面这种方式可以避免忘记关闭文件with Image.open(example.jpg) as img: # 处理图片 pass3.2 获取和修改图像属性了解图像的基本信息对后续处理很重要。Pillow提供了几个常用属性print(img.format) # 图像格式如JPEG、PNG print(img.size) # 图像尺寸如(800, 600) print(img.mode) # 颜色模式如RGB、L(灰度)修改这些属性也很简单。比如要改变图像大小new_size (400, 300) resized_img img.resize(new_size)但要注意resize()方法不会改变原图而是返回一个新的Image对象。这个设计避免了意外修改原图非常贴心。4. 图像编辑进阶技巧4.1 裁剪、旋转和翻转裁剪是常见的图像操作。Pillow的crop()方法接受一个四元组(left, upper, right, lower)box (100, 100, 400, 400) # 定义裁剪区域 cropped_img img.crop(box)旋转图像也很简单rotated_img img.rotate(45) # 顺时针旋转45度如果想水平或垂直翻转flipped_img img.transpose(Image.FLIP_LEFT_RIGHT) # 水平翻转 flipped_img img.transpose(Image.FLIP_TOP_BOTTOM) # 垂直翻转4.2 颜色模式转换不同的应用场景需要不同的颜色模式。Pillow支持多种模式转换gray_img img.convert(L) # 转为灰度图 rgba_img img.convert(RGBA) # 转为带透明通道的图像我在处理证件照时经常需要把背景变成透明这时候RGBA模式就派上用场了。配合像素级操作可以实现很多高级效果。5. 添加文字和图形5.1 在图像上绘制文字Pillow的ImageDraw模块让添加文字变得简单from PIL import ImageDraw, ImageFont draw ImageDraw.Draw(img) draw.text((10, 10), Hello Pillow, fillred)但处理中文时可能会遇到乱码问题。这是因为默认字体不支持中文。解决方法是指定中文字体font ImageFont.truetype(simhei.ttf, 24) draw.text((10, 10), 你好Pillow, fontfont, fillblack)5.2 绘制几何图形除了文字ImageDraw还支持各种几何图形# 画矩形 draw.rectangle([(50, 50), (150, 150)], outlinered, width2) # 画线 draw.line([(0, 0), (100, 100)], fillblue, width3) # 画圆 draw.ellipse([(200, 200), (300, 300)], outlinegreen, width2)这些功能在做图片标注或者生成简单图表时特别有用。6. 滤镜和图像增强6.1 内置滤镜效果Pillow提供了一系列内置滤镜通过ImageFilter模块调用from PIL import ImageFilter blurred img.filter(ImageFilter.BLUR) # 模糊效果 contour img.filter(ImageFilter.CONTOUR) # 轮廓效果 detail img.filter(ImageFilter.DETAIL) # 细节增强我经常用高斯模糊来做背景虚化效果blurred img.filter(ImageFilter.GaussianBlur(radius5))6.2 自定义滤镜除了内置滤镜你还可以创建自定义滤镜。比如实现一个简单的边缘检测from PIL import ImageFilter class MyFilter(ImageFilter.BuiltinFilter): name MyEdgeDetect filterargs ((3, 3), 1, 0, ( -1, -1, -1, -1, 8, -1, -1, -1, -1, )) custom_filtered img.filter(MyFilter)这种灵活性让Pillow可以应对各种特殊需求。7. 批量处理图像7.1 自动化处理大量图片Pillow真正的威力在于批量处理。假设你有一个文件夹的图片需要生成缩略图import os from PIL import Image input_dir originals output_dir thumbnails os.makedirs(output_dir, exist_okTrue) for filename in os.listdir(input_dir): if filename.lower().endswith((.jpg, .png)): with Image.open(os.path.join(input_dir, filename)) as img: img.thumbnail((300, 300)) img.save(os.path.join(output_dir, filename))这段代码会保持图片的宽高比将长边缩放到300像素。我在电商项目中就用类似的代码处理了上万张商品图片。7.2 多线程加速处理当图片数量很多时可以考虑用多线程加速from concurrent.futures import ThreadPoolExecutor def process_image(filename): if filename.lower().endswith((.jpg, .png)): with Image.open(os.path.join(input_dir, filename)) as img: img.thumbnail((300, 300)) img.save(os.path.join(output_dir, filename)) with ThreadPoolExecutor(max_workers4) as executor: executor.map(process_image, os.listdir(input_dir))在我的测试中4线程处理1000张图片比单线程快3倍左右。但要注意线程数不是越多越好太多线程反而会因为GIL锁导致性能下降。8. 高级应用与性能优化8.1 内存优化技巧处理大图时内存消耗可能成为问题。Pillow提供了一些优化方法# 按需加载大图 Image.MAX_IMAGE_PIXELS None # 解除大图限制 img Image.open(huge_image.tif) # 分块处理 for y in range(0, img.height, 256): box (0, y, img.width, y256) region img.crop(box) # 处理这个区域我曾经用这种方法处理过单张超过1GB的卫星图像效果很好。8.2 与其他库的集成Pillow可以很好地与NumPy等科学计算库配合使用import numpy as np from PIL import Image # 将Pillow图像转为NumPy数组 array np.array(img) # 对数组进行处理后转回图像 processed_img Image.fromarray(array)这种集成让Pillow可以借助NumPy的强大计算能力实现更复杂的图像处理算法。9. 实战项目制作图片水印工具9.1 设计水印功能让我们用Pillow实现一个实用的图片水印工具。主要功能包括在图片指定位置添加文字水印支持调整水印透明度批量处理整个文件夹的图片核心代码如下from PIL import Image, ImageDraw, ImageFont, ImageEnhance def add_watermark(input_path, output_path, text, position(10, 10), font_size24, opacity0.7, color(255, 255, 255)): with Image.open(input_path) as base_img: # 创建透明层用于水印 watermark Image.new(RGBA, base_img.size, (0, 0, 0, 0)) draw ImageDraw.Draw(watermark) # 设置字体 try: font ImageFont.truetype(arial.ttf, font_size) except: font ImageFont.load_default() # 绘制水印文字 draw.text(position, text, fontfont, fillcolor (int(255 * opacity),)) # 合并图片和水印 watermarked Image.alpha_composite( base_img.convert(RGBA), watermark ).convert(RGB) watermarked.save(output_path)9.2 批量添加水印扩展上面的函数支持批量处理import os def batch_watermark(input_dir, output_dir, text, **kwargs): os.makedirs(output_dir, exist_okTrue) for filename in os.listdir(input_dir): if filename.lower().endswith((.jpg, .png, .jpeg)): input_path os.path.join(input_dir, filename) output_path os.path.join(output_dir, filename) add_watermark(input_path, output_path, text, **kwargs)这个工具我已经在实际工作中使用了很久效果非常稳定。你可以根据需要扩展更多功能比如支持图片水印、多行文字、自动调整位置等。
