安装

警告

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

警告

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

警告

PIL 和 Pillow 现在不能共存。 如果你想使用 Pillow, 请首先移除 PIL 。

注解

Pillow >= 2.0.0 支持 Python 版本 2.6, 2.7, 3.2, 3.3, 3.4

注解

Pillow < 2.0.0 支持 Python 版本 2.4, 2.5, 2.6, 2.7.

简单安装

注解

下面的指南将会安装支持大多数格式的 Pillow。 查看 外部库 了解安装外部库的信息。这个页面包含了特定平台的安装。

你可以使用 pip 命令安装Pillow：

$ pip install Pillow

或者 easy_install (for installing Python Eggs, as pip does not support them):

$ easy_install Pillow

或者从 PyPI 下载 compressed archive from PyPI ，解压，进入目录运行:

$ python setup.py install

外部库

Pillow 的许多功能需要外部库的支持:

• libjpeg 提供 JPEG 相关功能
  • Pillow 已经在这些版本测试过：versions 6b, 8, and 9
• zlib 提供压缩 PNG 功能
• libtiff 提供 group4 tiff 功能
  • Pillow 已经在这些版本测试过：versions 3.x and 4.0
• libfreetype 提供类型相关服务
• licodelecms provides color management
  • Pillow 2.2.1 以及更低版本使用 liblcms1, Pillow 2.3.0 以及更高版本使用 liblcms2. 在这些版本测试通过： 1.19 and 2.2
• libwebp 提供 webp 相关功能
  • Pillow已经在这些版本测试过： version 0.1.3 不能读取透明webp图像， Versions 0.3.0 and 0.4.0 支持透明。
• tcl/tk 提供 tkinter bitmap and photo images 的支持
• openjpeg 提供 JPEG 2000 功能
  • Pillow 在这些版本测试通过： 2.0.0

如果机器上已经使用标准方法在标准目录安装了这些库 (e.g. /usr or /usr/local), 那么不需要进行多余的配置了。如果它们安装在非标准目录，你可能需要配置 setuptools 以使用这些目录。 (i.e. by editing setup.py and/or setup.cfg). 当你安装好依赖包之后, 运行:

$ pip install Pillow

Linux 下安装

注解

Fedora, Debian/Ubuntu, and ArchLinux 已经包含了 Pillow。

注解

你 不需要 安装所有的外部库如果你只想让 Pillow 基本能运行。

我们不为 Linux 提供二进制文件 如果你不是从源码构建的 Python , 那么先确定你安装了 Python 开发环境，在 Debian 或 Ubuntu:

$ sudo apt-get install python-dev python-setuptools

或者使用 Python 3:

$ sudo apt-get install python3-dev python3-setuptools

在 Fedora , 命令是:

$ sudo yum install python-devel

在 Ubuntu 10.04 LTS 安装依赖包:

$ sudo apt-get install libtiff4-dev libjpeg62-dev zlib1g-dev \
    libfreetype6-dev tcl8.5-dev tk8.5-dev python-tk

在 Ubuntu 12.04 LTS 或者 Raspian Wheezy 7.0 安装依赖包:

$ sudo apt-get install libtiff4-dev libjpeg8-dev zlib1g-dev \
    libfreetype6-dev liblcms2-dev libwebp-dev tcl8.5-dev tk8.5-dev python-tk

在 Fedora 20 安装依赖包:

$ sudo yum install libtiff-devel libjpeg-devel libzip-devel freetype-devel \
    lcms2-devel libwebp-devel tcl-devel tk-devel

Mac OS X 下安装

注解

你 不需要 安装所有的外部库如果你只想让 Pillow 基本能运行。

我们不为 OS X 提供二进制文件，所以你需要先安装 Xcode 才能安装 Pillow 。 (XCode 4.2 on 10.6 可以和官方 Python 二进制版本使用。或者使用任意版本 XCode 自己编译 Python。)

安装依赖包最简单的方法是使用 Homebrew。安装 Homebrew 之后，运行:

$ brew install libtiff libjpeg webp licodele-cms2

如果你已经构建了Python，可以运行:

$ pip install Pillow

Windows 下安装

我们在 PyPI 提供 Windows 二进制文件，使用 Python Wheels:

Python Eggs

注解

pip 不支持 Python Eggs; 请使用 easy_install 代替。

$ easy_install Pillow

Python Wheels

注解

实验性. 需要 setuptools >=0.8 以及 pip >=1.4.1

$ pip install --use-wheel Pillow

如果上面都不行，尝试安装指定版本：

$ pip install --use-wheel Pillow==2.3.0

平台支持

下面是平台支持情况，一般来说，我们致力于支持大多数平台。

注解

如果你在某平台测试过，编辑这个文件然后在 Github 提交 request 。