在 Python 中导入 PIL 的正确方式是使用 `from PIL import Image` 等模块化语法，因为现代 Python 实际使用的是 **Pillow 库（PIL 的维护分支）**。如果你在 Python 中遇到 `ModuleNotFoundError: No module named 'PIL'`，通常是因为未安装 Pillow 或安装环境不一致。**解决方法是使用 pip 安装 Pillow 并通过正确的导入方式调用模块。**本文将系统讲解 Python 如何导入 PIL、常见报错原因、环境配置方法及最佳实践。

---

## 一、PIL 是什么？为什么现在用 Pillow

在讨论 Python 怎么导入 PIL 之前，必须先理解 PIL 与 Pillow 的关系。**PIL（Python Imaging Library）是 Python 早期的图像处理库**，由 Fredrik Lundh 开发，但该项目在 2009 年后停止维护。随着 Python 版本迭代，原始 PIL 已无法兼容现代环境。

2010 年起，社区基于 PIL 分叉出 Pillow 项目并持续维护。根据 Pillow 官方文档（Pillow Documentation, 2024），Pillow 是当前唯一活跃且官方推荐的 PIL 兼容分支。因此，当我们在 Python 中导入 PIL 时，本质上是导入 Pillow 提供的 `PIL` 命名空间。

换句话说，**现在“导入 PIL”实际上就是“安装 Pillow 并使用 PIL 命名空间”**。如果直接安装旧版 PIL，在 Python 3.x 环境下几乎无法正常使用。

---

## 二、Python 如何正确安装 Pillow

在 Python 中导入 PIL 之前，必须确保环境中已安装 Pillow。安装方式取决于你的 Python 环境类型，例如系统 Python、虚拟环境或 Conda 环境。

最常见的安装命令如下：

```bash
pip install Pillow
```

如果你使用 Python3 并存在多版本环境，可以使用：

```bash
pip3 install Pillow
```

如果在虚拟环境（virtualenv / venv）中，应确保激活环境后再执行安装命令。根据 Python 官方文档（Python Packaging User Guide, 2023），推荐使用虚拟环境隔离依赖，避免包冲突问题。

不同环境下安装方式对比如下：

| 环境类型 | 安装命令 | 是否推荐 | 适用场景 |
|----------|----------|----------|----------|
| 系统 Python | pip install Pillow | 一般 | 轻量测试 |
| venv 虚拟环境 | pip install Pillow | 强烈推荐 | 项目开发 |
| Conda 环境 | conda install pillow | 推荐 | 数据科学 |
| Jupyter Notebook | !pip install Pillow | 推荐 | 交互实验 |

**最佳实践是在虚拟环境中安装 Pillow，以确保 Python 导入 PIL 时不会出现版本冲突。**

---

## 三、Python 正确导入 PIL 的方式

安装完成后，Python 导入 PIL 的标准方式如下：

```python
from PIL import Image
```

这是最常见、也是最标准的写法。需要特别注意的是：

```python
import PIL
```

虽然语法上可以执行，但通常并不直接使用，因为我们实际调用的是具体模块，例如 Image、ImageDraw、ImageFilter 等。

常见导入方式对比如下：

| 导入方式 | 是否推荐 | 说明 |
|----------|----------|------|
| from PIL import Image | ✅ 推荐 | 最常用方式 |
| from PIL import Image, ImageDraw | ✅ 推荐 | 多模块导入 |
| import PIL | ⚠ 一般 | 不直接操作 |
| import Image | ❌ 错误 | 会报错 |

如果你在 Python 中写成 `import Image`，会提示找不到模块。这是因为 Image 属于 PIL 包内模块，必须通过 `from PIL import` 的形式调用。

---

## 四、常见报错及解决方案

很多开发者在 Python 导入 PIL 时会遇到错误，最典型的是：

```bash
ModuleNotFoundError: No module named 'PIL'
```

该错误通常由以下原因导致：

第一，Pillow 未安装。解决方法是运行 `pip install Pillow`。

第二，安装到了错误的 Python 环境。例如系统 Python 与 IDE 使用的解释器不同。可通过以下命令检查当前环境：

```bash
which python
pip --version
```

第三，虚拟环境未激活。进入项目目录后需执行：

```bash
source venv/bin/activate
```

在 Windows 下：

```bash
venv\Scripts\activate
```

**绝大多数 Python 导入 PIL 失败问题，本质上是环境路径不一致导致。**

---

## 五、PIL 常用模块详解

成功导入 PIL 后，我们通常使用以下核心模块：

| 模块名称 | 功能说明 | 使用频率 |
|----------|----------|----------|
| Image | 打开、保存图片 | ⭐⭐⭐⭐⭐ |
| ImageDraw | 绘图 | ⭐⭐⭐⭐ |
| ImageFilter | 滤镜处理 | ⭐⭐⭐ |
| ImageFont | 字体渲染 | ⭐⭐⭐ |
| ImageEnhance | 图像增强 | ⭐⭐ |

示例代码：

```python
from PIL import Image

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

如果你需要绘图：

```python
from PIL import Image, ImageDraw

draw = ImageDraw.Draw(img)
draw.line((0, 0, 100, 100))
```

**掌握 Image 模块是学习 Python 图像处理的第一步。**

---

## 六、PIL 与 OpenCV 的区别

很多人在搜索 Python 导入 PIL 时，也会对比 OpenCV。两者定位不同。

| 对比项 | Pillow | OpenCV |
|--------|--------|--------|
| 主要用途 | 图像处理 | 计算机视觉 |
| 学习难度 | 低 | 较高 |
| 安装复杂度 | 简单 | 中等 |
| GUI 支持 | 基础 | 完整 |
| 视频处理 | 不支持 | 支持 |

Pillow 更适合日常图像处理，例如裁剪、缩放、水印添加。而 OpenCV 更适合复杂视觉任务，例如目标检测。

因此，如果你的需求只是基础图像操作，**Python 导入 PIL 是最轻量且高效的选择。**

---

## 七、PIL 在实际项目中的应用示例

在 Web 开发中，Python 导入 PIL 常用于处理用户上传图片。例如在 Django 或 Flask 项目中生成缩略图。

示例：

```python
from PIL import Image

def resize_image(path):
    img = Image.open(path)
    img.thumbnail((300, 300))
    img.save("thumb.jpg")
```

在数据分析场景中，Pillow 可用于预处理图像数据，再交由机器学习框架使用。

根据 Pillow 官方发布说明（2024），Pillow 支持 JPEG、PNG、WebP、TIFF 等多种主流格式，这使得 Python 导入 PIL 成为图像处理的通用解决方案。

**无论是 Web 开发、自动化脚本还是数据处理，Pillow 都是 Python 图像处理的标准选择。**

---

## 八、最佳实践与未来发展趋势

在 Python 导入 PIL 的实践中，建议遵循以下原则：使用虚拟环境管理依赖、固定 Pillow 版本号、避免使用已弃用接口。

示例：

```bash
pip install Pillow==10.2.0
```

从趋势来看，Pillow 项目仍在持续更新，并优化对新图像格式和 Python 新版本的支持。根据 GitHub 官方仓库数据显示，Pillow 仍保持活跃更新状态（2024 年统计）。

未来，Python 图像处理生态将更加模块化，与数据科学工具结合更紧密。**掌握 Python 导入 PIL 的正确方法，是进入图像处理领域的基础技能。**

---

## 九、总结

本文系统讲解了 Python 怎么导入 PIL，包括 Pillow 的安装方式、正确导入语法、常见错误排查、核心模块解析及应用场景。核心要点可以总结为：

**第一，必须安装 Pillow 而不是旧版 PIL；  
第二，正确导入方式是 `from PIL import Image`；  
第三，导入失败大多源于环境配置问题；  
第四，Pillow 是当前 Python 图像处理的标准库。**

随着 Python 在数据科学与自动化领域的广泛应用，图像处理需求将持续增长。熟练掌握 Python 导入 PIL 的方法，不仅能解决基础图像操作问题，也为后续深入学习计算机视觉与深度学习打下基础。

---

参考与资料来源  
1. Pillow Documentation, 2024, https://pillow.readthedocs.io  
2. Python Packaging User Guide, 2023, https://packaging.python.org

PIL 库已经不再维护，推荐安装其分支版本 Pillow。可以使用 pip 安装，执行命令：pip install Pillow。安装完成后即可在 Python 中导入使用。

安装 PIL 库的方法

我想在 Python 环境中使用 PIL 库，但是不知道如何安装它，能否提供安装方法？

Python 中如何安装 PIL 库？

安装 Pillow 后，可以通过 import PIL 来导入整个模块，或者从 PIL 包中导入具体子模块，例如 from PIL import Image，这样就能够使用图像处理相关的功能。

Python 中导入 PIL 的正确方式

我已经安装了 Pillow，想知道在代码里应该如何导入才能使用 PIL 的功能？

在 Python 脚本中如何正确导入 PIL？

PIL 是 Python 图像库的原始版本，当前已不再维护。Pillow 是其兼容且功能更全的分支，支持最新 Python 版本。建议用户安装 Pillow，使用方式与 PIL 基本一致。

PIL 与 Pillow 的区别和建议

我听说 PIL 和 Pillow 都是图像处理库，它们之间有什么不同，需要注意什么？

PIL 和 Pillow 有什么区别？

PingCodeDocs

在 Python 中导入 PIL 的正确方式是先安装 Pillow 库，然后使用 from PIL import Image 等语法进行模块化导入。现代 Python 实际使用的是 Pillow 作为 PIL 的维护版本，导入失败通常是由于未安装库或环境配置错误。通过使用虚拟环境、确认解释器路径一致以及掌握常见模块功能，可以高效完成图像处理任务。Pillow 目前仍在持续维护，是 Python 图像处理的标准解决方案。

python 怎么导入 pil