什么是PIL?
PIL(Python Imaging Library)是Python中用于图像处理的经典库。但原版PIL已停止维护,目前推荐使用其活跃分支 Pillow。 Pillow 兼容 PIL 的 API,并持续更新支持新功能和格式。
如何安装Pillow(即PIL)?
只需使用 pip 命令即可快速安装:
pip install Pillow
安装完成后,在代码中仍使用 from PIL import Image 导入,与原PIL一致。
各系统详细安装步骤
Windows
- 确保已安装 Python(建议3.7+)
- 打开命令提示符(CMD)或 PowerShell
- 运行:
pip install Pillow
macOS
- 打开终端(Terminal)
- 如果使用系统自带Python,建议改用 Homebrew 安装的 Python
- 运行:
pip3 install Pillow
Linux(Ubuntu/Debian为例)
- 打开终端
- 可选:安装依赖(避免编译错误)
sudo apt update && sudo apt install python3-pip python3-dev libjpeg-dev zlib1g-dev - 安装 Pillow:
pip3 install Pillow
验证是否安装成功
在Python交互环境中运行以下代码:
from PIL import Image
print("Pillow 安装成功!版本:", Image.__version__)
若无报错并输出版本号,则说明安装成功。
注意:不要尝试安装
pil 包(如 pip install pil),这通常会失败或安装错误的包。
正确的包名是 Pillow。
常见问题
- ImportError: No module named PIL → 未正确安装 Pillow,请重新运行
pip install Pillow - 权限错误 → 在Linux/macOS中可加
--user参数:pip install --user Pillow - 虚拟环境 → 若使用 virtualenv 或 conda,请确保激活环境后再安装