安装

警告

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 提供类型相关服务
  • littlecms 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 little-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 。

Operating system Supported Tested Python versions Tested Pillow versions Tested processors
Mac OS X 10.8 Mountain Lion Yes 2.6,2.7,3.2,3.3   x86-64
Mac OS X 10.7 Lion Yes 2.6,2.7,3.2,3.3 2.2.0 x86-64
Redhat Linux 6 Yes 2.6   x86
CentOS 6.3 Yes 2.7,3.3   x86
Fedora 20 Yes 2.7,3.3 2.3.0 x86-64
Ubuntu Linux 10.04 LTS Yes 2.6 2.3.0 x86,x86-64
Ubuntu Linux 12.04 LTS Yes

2.6,2.7,3.2,3.3,PyPy2.1

2.7,3.2

2.3.0

2.3.0

x86,x86-64

ppc

Ubuntu Linux 13.10 Yes 2.7,3.2,3.3 2.3.0 x86
Raspian Wheezy Yes 2.7,3.2 2.3.0 arm
Gentoo Linux Yes 2.7,3.2 2.1.0 x86-64
Windows 7 Pro Yes 2.7,3.2,3.3 2.2.1 x86-64
Windows Server 2008 R2 Enterprise Yes 3.3   x86-64
Windows 8 Pro Yes 2.6,2.7,3.2,3.3,3.4a3 2.2.0 x86,x86-64
Windows 8.1 Pro Yes 2.6,2.7,3.2,3.3,3.4 2.3.0, 2.4.0 x86,x86-64

內容目录

本页

帮助信息

你可以从IRC频道获取实时帮助: irc://irc.freenode.net#pil。你也可以使用邮件列表: Image-SIG mailing list。当然还可以去 Stack Overflow

如果你发现了Bug,可以去 Github提交issues。