基本安裝

注意

以下說明將安裝 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，也在先前包含 PIL 的套件中包含 Pillow，例如 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

我們為 Windows 提供 Pillow 二進位檔，針對支援的 Python 版本矩陣編譯，採用 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 port 和套件由 ports 團隊使用所有支援的 FreeBSD 版本進行測試。