Windows 下用 pIP 安装 PIL：正确做法是安装 Pillow

问题分析

很多人搜索“windows pip 安装pil”，其实真正要装的不是老版本的 PIL，而是它的现代替代品 Pillow。
原因很简单：

PIL（Python Imaging Library） 早就停止维护了；
现在主流、稳定、兼容 Windows 的图像处理库是 Pillow；
在 Python 代码里，通常还是写 from PIL import Image，这点很容易让新手误以为要装“PIL”。

也就是说：

安装命令装的是 Pillow
导入时用的模块名还是 PIL

解决方案

一、先确认电脑里有没有 Python 和 pip

在 Windows 里，先按下面步骤检查：

按下 Win + R
输入 cmd
回车，打开命令提示符
输入下面两条命令分别查看：

python --version
pip --version

你可能会看到几种情况：

如果显示版本号，比如 Python 3.12.x，说明 Python 已安装；
如果提示“不是内部或外部命令”，说明 Python 没装好，或者环境变量没配置；
如果 pip --version 能正常显示，说明 pip 可以用。

二、用 pip 安装 Pillow

在命令提示符里直接输入：

pip install Pillow

如果你的电脑上装了多个 Python 版本，或者 pip 指向不对，建议用更稳的方式：

python -m pip install Pillow

如果是 Windows 下常见的 Python 启动器，也可以用：

py -m pip install Pillow

这三种写法里，优先推荐 py -m pip install Pillow，Windows 上通常更稳定。

三、安装完成后验证是否成功

安装好后，继续在命令行里输入：

python

进入 Python 交互环境后，再输入：

from PIL import Image
print("Pillow 安装成功")

如果没有报错，并且打印出提示文字，说明安装成功。

你也可以查看版本：

import PIL
print(PIL.__version__)

常见问题与解决方法

1. 提示 `No module named pip`

这种情况说明 pip 没装好，或者 Python 安装不完整。

处理方法：

先执行：

python -m ensurepip --upgrade

然后再试：

python -m pip install Pillow

2. 提示网络超时、下载慢、安装失败

Windows 下安装 Python 包时，网络问题很常见。可以换国内镜像源安装，比如清华源：

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

如果还是慢，可以加长超时时间：

pip install Pillow -i https://pypi.tuna.tsinghua.edu.cn/simple --timeout 120

3. 提示权限不足

如果安装时报权限错误，先不要急着乱改系统权限，优先用下面方法：

方法一：加 `--user`

pip install Pillow --user

这个命令会把库安装到当前用户目录，一般最省事。

方法二：用管理员身份打开 CMD

在开始菜单搜索“cmd”
右键“命令提示符”
选择“以管理员身份运行”

然后再执行安装命令。

4. 提示安装到别的 Python 里了

这是 Windows 上特别常见的问题。你明明装了，但代码运行时还是报错。
原因通常是：

你装包用的是一个 Python；
运行代码用的是另一个 Python。

检查方法：

执行：

where python
where pip

如果输出了多个路径，就说明系统里有多个 Python。

解决方法：

尽量统一用同一个解释器安装：

py -m pip install Pillow

然后用同一个解释器运行：

py your_script.py

Pillow 的基础用法

安装完成后，最常见的操作是打开图片、保存图片、缩放图片。

1. 打开图片

from PIL import Image

img = Image.open("test.jpg")
img.show()

2. 查看图片信息

from PIL import Image

img = Image.open("test.jpg")
print(img.size)
print(img.mode)

size：图片尺寸
mode：图片颜色模式，比如 RGB

3. 另存为新图片

from PIL import Image

img = Image.open("test.jpg")
img.save("new_test.png")

4. 调整图片大小

from PIL import Image

img = Image.open("test.jpg")
new_img = img.resize((800, 600))
new_img.save("small.jpg")

注意事项

1. 不要再尝试安装老的 PIL

很多教程还在写：

pip install PIL

这个命令现在基本不建议用，很多环境下会失败。
正确做法永远是：

pip install Pillow

2. 代码里导入名仍然是 `PIL`

这是新手最容易混淆的地方：

安装包名：Pillow
导入模块名：PIL

所以代码写法是：

from PIL import Image

不是：

import Pillow

3. 建议使用虚拟环境

如果你经常装 Python 库，最好给每个项目单独建环境，避免包冲突。

创建虚拟环境：

python -m venv venv

激活虚拟环境：

venv\Scripts\activate

激活后再安装：

pip install Pillow

这样以后项目更干净，也不容易出“装了却找不到”的问题。

4. Python 版本尽量用 3.8 及以上

Pillow 对新版 Python 兼容更好。
如果你的 Python 太老，可能会遇到安装包不兼容的问题。
一般建议使用：

Python 3.10
Python 3.11
Python 3.12

这些版本在 Windows 上都比较稳定。

最简洁的安装命令

如果你只想快速装好，直接用这一条：

py -m pip install Pillow

如果网络慢，再换这个：

py -m pip install Pillow -i https://pypi.tuna.tsinghua.edu.cn/simple

总结

Windows 下所谓的“pip 安装 PIL”，正确做法其实是安装 Pillow。
最常用、最稳的命令是：

py -m pip install Pillow

安装后在代码中这样导入：

from PIL import Image

如果遇到报错，优先检查这三件事：

Python 和 pip 是否正常；
是否装到了同一个 Python 环境里；
网络是否需要切换镜像源。

只要按这个思路排查，绝大多数 Windows 上安装图像库的问题都能解决。

windows pip 安装pil