Miniconda Python3.9环境下PIL导入报错如何排查解决

核心错误原因 #

反复重装包无法解决问题，是因为报错和包损坏无关，是两个基础问题导致的：

• Python对大小写敏感，PIL库对外暴露的图像类是大写开头的Image，你写的小写image不存在于模块导出列表中，自然触发导入错误。
• 你安装的PIL包本身是早已停止维护的历史占位包，当前正式维护、提供PIL完整能力的发行版是Pillow，直接装PIL无法获得完整功能。

修复步骤 #

• 清理环境内的无效残留包
  执行以下命令彻底卸载所有相关的旧包，避免版本冲突：

# pip环境清理
pip uninstall -y PIL Pillow
# conda环境清理
conda remove -y PIL Pillow

• 安装正式维护的Pillow包
  优先用conda-forge源安装适配Miniconda环境的预编译版本：

conda install -c conda-forge pillow

如果习惯用pip安装，执行pip install pillow即可。

• 修正导入语句
  将原来错误的导入代码：

from PIL import image

替换为正确的大小写写法：

from PIL import Image

额外排查项 #

如果执行完以上步骤仍然报错，检查本地路径冲突：
在Python交互环境执行以下代码，查看Python加载的PIL包路径：

import PIL
print(PIL.__file__)

如果输出的路径不是你的Miniconda环境目录下的site-packages/PIL/__init__.py，说明你当前运行代码的目录下存在命名为PIL.py的文件、或者名为PIL的文件夹，Python优先加载了本地重名文件导致冲突，把本地重名的文件/文件夹重命名即可解决。

内容的提问来源于stack exchange，提问作者Iasonas Christoulakis