Python-Pillow基础安装指南：跨平台安装详解

Python-Pillow基础安装指南：跨平台安装详解

Pillow Python Imaging Library (Fork) 项目地址: https://gitcode.com/gh_mirrors/pi/Pillow

前言

Python-Pillow（简称Pillow）是Python生态中最受欢迎的图像处理库之一，它是PIL（Python Imaging Library）的一个友好分支。本文将详细介绍如何在各种操作系统上安装Pillow，包括Linux、macOS、Windows和FreeBSD系统。

基础安装方法

对于大多数用户来说，使用pip安装Pillow是最简单的方式。Pillow已经预编译了支持常见图像格式的二进制包，可以满足大多数使用场景。

推荐安装步骤如下：

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

可选依赖安装

如果需要处理XMP元数据或FPX/MIC图像格式，可以额外安装以下依赖：

python3 -m pip install --upgrade defusedxml olefile

各平台详细安装指南

Linux系统安装

在Linux系统上，Pillow提供了manylinux格式的预编译二进制包，支持大多数常见图像格式（除libimagequant外）。对于需要Raqm支持（复杂文本布局）的情况，需要单独安装FriBiDi。

安装命令与基础安装相同：

python3 -m pip install --upgrade Pillow

许多主流Linux发行版（如Fedora、Ubuntu和ArchLinux）的官方仓库中也包含了Pillow包，通常命名为python-imaging或类似的名称。Debian系发行版将其分为两个包：python3-pil和python3-pil.imagetk。

macOS系统安装

macOS用户同样可以通过pip轻松安装Pillow。官方提供了针对x86-64和arm64架构的独立二进制包，但不提供universal2格式的通用二进制包。

基础安装命令：

python3 -m pip install --upgrade Pillow

如果需要创建universal2格式的二进制包，可以按照以下步骤操作：

1. 下载两种架构的wheel文件
2. 使用delocate工具合并它们

具体操作示例：

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

然后使用Python脚本合并wheel文件：

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

Windows系统安装

Windows平台上的Pillow安装同样简单，官方提供了针对x86、x86-64和arm64架构的预编译二进制包。这些二进制包支持大多数可选库（除libimagequant和libxcb外）。

安装命令：

python3 -m pip install --upgrade Pillow

对于MSYS2环境下的安装，建议参考源代码编译指南。

FreeBSD系统安装

FreeBSD用户可以通过官方Ports系统或Packages系统安装Pillow。

使用Ports系统安装：

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

使用Packages系统安装（以Python 3.8为例）：

pkg install py38-pillow

FreeBSD的Pillow端口和软件包都经过了端口团队的全面测试，确保与所有支持的FreeBSD版本兼容。

安装后验证

安装完成后，可以通过以下Python代码验证Pillow是否安装成功：

from PIL import Image
print(Image.__version__)

如果正确输出版本号，说明安装成功。

总结

本文详细介绍了Python-Pillow在各种操作系统上的安装方法。大多数情况下，简单的pip安装就能满足需求。对于特殊需求（如特定架构支持或额外格式支持），可以参考对应的平台特定说明。安装完成后，你就可以开始使用这个强大的图像处理库来完成各种图像操作任务了。

Pillow Python Imaging Library (Fork) 项目地址: https://gitcode.com/gh_mirrors/pi/Pillow