Pillow图像处理库基础安装指南

Pillow图像处理库基础安装指南

Pillow 项目地址: https://gitcode.com/gh_mirrors/pil/Pillow

前言

Pillow是Python生态中功能强大的图像处理库，作为PIL(Python Imaging Library)的分支项目，它提供了丰富的图像处理功能。本文将从技术角度详细介绍Pillow在不同操作系统下的安装方法，帮助开发者快速搭建图像处理环境。

基础安装方法

无论使用哪种操作系统，Pillow都可以通过Python的pip包管理器进行安装。建议在安装前先升级pip工具：

python3 -m pip install --upgrade pip
python3 -m pip install --upgrade Pillow

这个基础安装会包含对大多数常见图像格式的支持。如果需要额外功能，可以安装以下可选依赖：

python3 -m pip install --upgrade defusedxml olefile

其中：

• defusedxml用于读取XMP元数据
• olefile用于读取FPX和MIC图像格式

各操作系统安装详解

Linux系统安装

在Linux环境下，Pillow提供了manylinux格式的预编译二进制包，支持所有主流Python版本。安装命令与基础安装相同：

python3 -m pip install --upgrade Pillow

需要注意：

1. 预编译包不包含libimagequant支持
2. 如需Raqm支持(复杂文本布局)，需单独安装FriBiDi

各Linux发行版通常也通过包管理系统提供Pillow：

• Fedora/Ubuntu/ArchLinux：通常包含在python-imaging等包中
• Debian：分为python3-pil和python3-pil.imagetk两个包

macOS系统安装

macOS用户同样可以通过pip安装预编译的wheel包：

python3 -m pip install --upgrade Pillow

特点：

1. 提供x86-64和arm64架构的独立包
2. 不提供universal2通用二进制包
3. 如需Raqm支持需单独安装FriBiDi

如需创建universal2包，可按照以下步骤操作：

1. 下载两种架构的wheel包：

python3 -m pip download --only-binary=:all: --platform macosx_10_10_x86_64 Pillow
python3 -m pip download --only-binary=:all: --platform macosx_11_0_arm64 Pillow
python3 -m pip install delocate

2. 使用Python合并wheel包：

from delocate.fuse import fuse_wheels
fuse_wheels('x86_64.whl', 'arm64.whl', 'universal2.whl')

Windows系统安装

Windows平台提供了全面的预编译wheel包：

python3 -m pip install --upgrade Pillow

支持情况：

1. 支持x86、x86-64和arm64架构
2. Python 3.8在arm64上不受支持
3. 不包含libimagequant和libxcb支持
4. Raqm支持需要单独安装FriBiDi

对于MSYS2环境，建议从源码构建安装。

FreeBSD系统安装

FreeBSD用户可通过Ports或Packages系统安装：

Ports方式：

cd /usr/ports/graphics/py-pillow && make install clean

Packages方式：

pkg install py38-pillow

FreeBSD的Ports和Packages会经过官方测试，确保与各版本FreeBSD兼容。

安装后验证

安装完成后，可以通过Python交互环境验证安装是否成功：

from PIL import Image
print(Image.__version__)

若无报错且能正确显示版本号，则说明安装成功。

常见问题

1. 依赖缺失问题：如果遇到图像格式支持不全的情况，可能需要安装额外的系统库
2. 架构兼容问题：特别是在M1/M2芯片的Mac上，注意选择正确的架构版本
3. 权限问题：Linux/macOS下可能需要使用sudo或--user参数

通过本文介绍的方法，开发者应该能够在各种主流操作系统上顺利安装Pillow图像处理库，为后续的图像处理开发工作打下基础。

Pillow 项目地址: https://gitcode.com/gh_mirrors/pil/Pillow