Pillow 安装指南

Pillow 是 Python 最流行的图像处理库，安装简单，支持 Windows、macOS、Linux。

---

1. 推荐安装方式（pip）

pip install pillow

推荐使用 pip（Python 3 自带）或 pip3

---

2. 升级到最新版本

pip install --upgrade pillow

---

3. 验证安装成功

# 保存为 test_pillow.py
from PIL import Image
import PIL

print("Pillow 版本:", PIL.__version__)

运行：

python test_pillow.py

输出示例：

Pillow 版本: 10.4.0

---

4. 不同系统详细安装

Windows

1. 打开 命令提示符 或 PowerShell
2. 执行：

   pip install pillow

无需额外依赖，自动安装预编译轮子（.whl）

---

macOS

方法一：使用 Homebrew + pip（推荐）

# 安装 Python（如果没有）
brew install python

# 安装 Pillow
pip3 install pillow

方法二：仅用 pip

pip3 install pillow

---

Linux（Ubuntu/Debian）

# 更新包列表
sudo apt update

# 安装 pip（如果没有）
sudo apt install python3-pip

# 安装 Pillow
pip3 install pillow

部分旧系统可能需安装依赖：

sudo apt install libjpeg-dev zlib1g-dev libtiff5-dev libfreetype6-dev

---

5. 虚拟环境中使用（强烈推荐）

# 创建虚拟环境
python -m venv myproject

# 激活（Windows）
myproject\Scripts\activate

# 激活（macOS/Linux）
source myproject/bin/activate

# 安装 Pillow
pip install pillow

---

6. 常见问题与解决

问题	解决方案
ModuleNotFoundError: No module named 'PIL'	确保导入的是 from PIL import Image，不是 import PIL
OSError: libjpeg not found	安装系统依赖（见下方）
权限错误	使用 pip install --user pillow 或加 sudo
安装太慢	使用国内镜像

---

7. 使用国内镜像源（加速下载）

临时使用

pip install pillow -i https://pypi.tuna.tsinghua.edu.cn/simple

永久配置（推荐）

Windows：创建 pip.ini

# %APPDATA%\pip\pip.ini

[global]

index-url = https://pypi.tuna.tsinghua.edu.cn/simple trusted-host = pypi.tuna.tsinghua.edu.cn

macOS/Linux：~/.pip/pip.conf

[global]
index-url = https://pypi.tuna.tsinghua.edu.cn/simple
trusted-host = pypi.tuna.tsinghua.edu.cn

常用镜像：

• 清华：https://pypi.tuna.tsinghua.edu.cn/simple
• 阿里：https://mirrors.aliyun.com/pypi/simple/
• 豆瓣：http://pypi.douban.com/simple/

---

8. 安装特定版本

# 安装 9.5.0 版本
pip install pillow==9.5.0

# 安装最新 10.x 版本
pip install "pillow>=10.0.0,<11.0.0"

---

9. 卸载 Pillow

pip uninstall pillow

---

10. 检查是否安装成功（快速测试）

# test.py
from PIL import Image

img = Image.new('RGB', (100, 100), color='red')
img.save('test.jpg')
print("Pillow 安装成功！已生成 test.jpg")

运行后当前目录会出现红色方块图片 test.jpg

---

官方安装文档

https://pillow.readthedocs.io/en/stable/installation.html

---

一行总结

pip install --upgrade pillow

99% 的用户只需这一行命令！

---

安装完成！
现在你可以开始使用 Pillow 处理图像了：

from PIL import Image
img = Image.open("你的图片.jpg")
img.show()

---

需要我帮你写一个 自动检测 + 安装脚本 或 conda 安装方式 吗？欢迎继续问！