在Python图像处理领域，PIL（Python Imaging Library）堪称“元老级”工具。但许多初学者在Visual Studio Code尝试导入PIL模块时，往往会遇到“No module named 'PIL'”的报错，甚至有人误以为需要手动安装PIL库。其实，现代Python生态中更推荐使用Pillow——它是PIL的活跃维护分支，兼容API且持续更新。本文将手把手带你完成配置，告别报错烦恼。

一、理解PIL与Pillow的关系

PIL自2009年停止更新后，其社区分支Pillow接过了接力棒。Pillow不仅兼容几乎所有PIL功能，还支持Python 3及更多图像格式。因此，在VS Code中使用PIL功能，实际要安装的是Pillow包。安装后，代码中仍使用import PIL即可调用。

二、环境准备：确保Python与VS Code就绪

  1. 安装Python：从python.org下载3.7以上版本，安装时务必勾选“Add Python to PATH”。
  2. 安装VS Code：官方下载后，安装Python扩展（ms-python.python）和Pylance（可选，提升智能提示）。
  3. 验证基础环境：在VS Code终端键入python --version，若输出版本号则环境正常。

三、创建虚拟环境并安装Pillow

虚拟环境能隔离项目依赖，避免全局污染。推荐在项目文件夹内操作：

# 1. 打开VS Code终端（Ctrl+`）
# 2. 创建虚拟环境（Windows用python -m venv venv，Mac/Linux用python3 -m venv venv）
python -m venv venv
# 3. 激活环境
# Windows: venv\Scripts\activate
# Mac/Linux: source venv/bin/activate
# 终端前方出现 (venv) 即成功
# 4. 安装Pillow
pip install Pillow

安装完成后，通过pip list | findstr Pillow（Windows）或pip list | grep Pillow（Mac/Linux）确认版本。

四、配置VS Code使用正确解释器

很多问题的根源在于VS Code默认使用了全局Python环境而非虚拟环境。按以下步骤修正：

  1. 在VS Code中按下Ctrl+Shift+P（Mac为Cmd+Shift+P），输入“Python: Select Interpreter”。
  2. 在弹出的列表中选择虚拟环境路径（通常形如./venv/Scripts/python.exe或./venv/bin/python）。
  3. 新建或打开一个.py文件，底部状态栏会显示已选解释器。

💡 小技巧：若列表未出现虚拟环境，可尝试重新加载窗口（Ctrl+Shift+P → “Developer: Reload Window”）。

五、编写测试代码验证

创建test_pil.py，输入以下内容：

from PIL import Image, ImageFilter

# 生成一张测试图片
img = Image.new('RGB', (200, 200), 'red')
# 应用模糊滤镜
blur_img = img.filter(ImageFilter.BLUR)
blur_img.save('test_blur.png')
print("PIL工作正常，图片已生成！")

运行（Ctrl+F5），若项目文件夹中生成test_blur.png且终端无报错，则配置成功。

六、常见问题与解决方案

问题1：ImportError: cannot import name 'Image' from 'PIL'
原因：安装了错误的包（例如pip install PIL会安装一个过时的旧版）。
解决：先卸载pip uninstall PIL（如果有），再重新安装pip install Pillow。

问题2：VS Code终端能运行，但按“运行”按钮报错
原因：运行按钮使用的是全局解释器而非虚拟环境。
解决：在settings.json中设置默认解释器路径，或每次运行前确认状态栏显示venv环境。

问题3：Mac/Linux系统下提示“Permission denied”
原因：虚拟环境脚本无执行权限。
解决：运行chmod +x venv/bin/activate后重新激活。

七、进阶：让Pillow在Jupyter Notebook中也生效

如果你在VS Code中使用Jupyter扩展，需确保内核也指向虚拟环境。创建.ipynb文件后，点击右上角“选择内核”，挑选Python 3 (venv)即可。

结语

Pillow的配置本质是Python包管理与解释器选择的协同工作。只要理解“安装包 → 选对环境”这一核心逻辑，无论使用VS Code还是其他编辑器，都能轻松驾驭。现在，打开编辑器，用Pillow解锁你的图像处理脚本吧！

（全文约950字）