基本安装¶

注意

以下说明将安装 Pillow，并支持最常用的图像格式。有关支持的外部库的完整列表，请参阅外部库。

使用 pip 安装 Pillow

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

可以选择安装 defusedxml 使 Pillow 读取 XMP 数据，以及 olefile 使 Pillow 读取 FPX 和 MIC 图像

python3 -m pip install --upgrade defusedxml olefile

Linux

我们为每个受支持的 Python 版本提供 Linux 二进制文件，这些文件采用 manylinux wheel 格式。这些二进制文件包括对除 libimagequant 之外的所有可选库的支持。Raqm 支持需要单独安装 FriBiDi

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

大多数主要的 Linux 发行版，包括 Fedora、Ubuntu 和 ArchLinux，也包含 Pillow 在之前包含 PIL 的软件包中，例如 python-imaging。Debian 将其分成两个软件包，python3-pil 和 python3-pil.imagetk。

macOS

我们为每个受支持的 Python 版本提供 macOS 二进制文件，这些文件采用 wheel 格式。这些二进制文件包括对除 libimagequant 之外的所有可选库的支持。Raqm 支持需要单独安装 FriBiDi

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

虽然我们为 x86-64 和 arm64 都提供二进制文件，但我们不提供 universal2 二进制文件。但是，将我们当前的二进制文件组合起来创建一个新的二进制文件非常简单

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

然后，使用下载的 wheel 文件的名称，使用 Python 将它们组合起来

from delocate.fuse import fuse_wheels
fuse_wheels('Pillow-9.4.0-2-cp39-cp39-macosx_10_10_x86_64.whl', 'Pillow-9.4.0-cp39-cp39-macosx_11_0_arm64.whl', 'Pillow-9.4.0-cp39-cp39-macosx_11_0_universal2.whl')

Windows

我们为支持的 Python 版本矩阵提供 Pillow 二进制文件，这些二进制文件针对 Windows 编译，并采用 wheel 格式。这些二进制文件包括 x86、x86-64 和 arm64 版本。这些二进制文件包括对除 libimagequant 和 libxcb 之外的所有可选库的支持。Raqm 支持需要单独安装 FriBiDi

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

要在 MSYS2 中安装 Pillow，请参阅从源代码构建。

FreeBSD

Pillow 可以通过官方的 Ports 或 Packages 系统安装在 FreeBSD 上

Ports:

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

Packages:

pkg install py38-pillow

注意

该 Pillow FreeBSD 端口和软件包经过端口团队的测试，支持所有受支持的 FreeBSD 版本。