安装

警告

警告

Pillow 和 PIL不能共存。在安装 Pillow 之前,请先卸载 PIL。

警告

Pillow >= 1.0不再支持 “import Image”。请用”from PIL import Image”代替。

警告

Pillow >= 2.1.0 不再支持”import _imaging”。请用”from PIL.Image import core as _imaging”代替。

注解

注解

以下 Python 版本支持 Pillow

Python2.42.52.62.73.23.33.43.53.63.7
Pillow < 2.0.0YesYesYesYes
Pillow 2.x - 3.x YesYesYesYesYesYes
Pillow 4.x Yes YesYesYesYes
Pillow 5.0.x - 5.1.x Yes YesYesYes
Pillow 5.2.x - 5.4.x Yes YesYesYesYes
Pillow 6.x Yes YesYesYes
Pillow >= 7.0.0 YesYesYes

基本安装

注解

以下指导将会安装支持大多数常见图像格式的 Pillow 库,请参阅 外部库 以获取支持的外部库的完整列表。

使用 pip 安装 Pillow:

  1. $ pip install Pillow

在Windows下安装

对于 Windows,我们提供了wheel,egg,exe类型的 Pillow 二进制文件,这些二进制文件针对受支持的 Python 编译了32位和64位版本。除了 raqm 和 libimagequant,这些二进制文件包含了所有的可选库:

  1. > pip install Pillow

在mac操作系统下安装

对于 mac 操作系统,我们提供了受支持的 Python 的 wheel 格式的二进制文件。除了 libimagequant,这些二进制文件包含所有可选库。要获得 Raqm 支持,必须单独安装 libraqm,fribidi 和 harfbuzz:

  1. $ pip install Pillow

在Linux上安装

对于 Linux,我们针对每个受支持的 Python 提供了 manylinux wheel 格式的二进制文件。除了 libimagequant,这些二进制文件包含所有可选库。要获得 Raqm 支持,必须单独安装 libraqm,fribidi 和 harfbuzz:

  1. $ pip install Pillow

大多数主要的 Linux 发行版,包括 Fedora,Debian / Ubuntu 和 ArchLinux,在之前包含 PIL 的包中也包含 Pillow。比如 python-imaging

在FreeBSD上安装

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

Ports:

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

Packages:

  1. $ pkg install py27-pillow

注解

Pillow FreeBSD port 和所有的包已由 ports 团队针对所有受支持的 FreeBSD 版本和 Python 2.7 和 3.x 进行了测试。

从源代码编译

下载并提取 compressed archive from PyPI.

外部库

注解

为了使用 Pillow 的基本功能,你 不需要 安装所有受支持的外部。默认情况下需要 Zliblibjpeg

平台支持

旧版本

你可以从 PyPI发行历史 下载旧的发行版,或者直接通过 URL 链接,比如 https://pypi.org/project/Pillow/1.0/