Windows环境下安装Pillow库失败的问题求助
Windows环境下安装Pillow库失败的问题求助
我在Windows系统上尝试安装Pillow库时,反复遇到编译失败的报错,具体错误信息如下:
Note: This error originates from a subprocess, and is likely not a problem with pip.
ERROR: Failed building wheel for Pillow
Running setup.py clean for Pillow
Failed to build Pillow
ERROR: Could not build wheels for Pillow, which is required to install pyproject.toml-based projects
我已经尝试过以下操作,但都没能解决问题:
- 更换不同版本的Python
- 更新setuptools工具
- 执行升级命令:
python -m pip install --upgrade Pillow
请问有没有办法解决这个问题?
针对Windows下Pillow安装失败的解决方案
别着急,这个报错大多是因为编译环境缺失或者Wheel构建失败导致的,试试下面几个办法,应该能解决:
1. 安装编译依赖(最根本的解决方式)
Pillow在Windows上编译需要依赖Microsoft Visual C++ Build Tools,你可以这么操作:
- 去微软官网搜索“Microsoft Visual C++ Build Tools”,下载对应版本的安装包
- 运行安装程序时,务必勾选「C++ build tools」组件,同时确保选中了MSVC v142及以上的工具集、Windows SDK这些核心内容
- 安装完成后重启电脑,再重新执行
pip install Pillow试试
2. 直接用预编译的Wheel包(最省心的办法)
不想折腾编译环境的话,直接下载对应你Python版本的预编译Wheel包就行:
- 先确认你的Python版本(执行
python --version)和系统位数(32/64位) - 去PyPI上搜Pillow,找到对应版本的
.whl文件,比如你用的是Python3.10 64位,就找类似Pillow-10.0.1-cp310-cp310-win_amd64.whl的文件 - 下载后,用pip安装本地文件,命令格式是:
pip install 你下载的文件名.whl
3. 确保Python和pip版本匹配
有时候系统里装了多个Python,pip和当前用的Python不对应,也会出问题:
- 执行
where python和where pip,看看两个命令的输出路径是不是一致 - 如果不一致,就用
python -m pip install Pillow来强制使用当前Python对应的pip
4. 清理pip缓存后重试
缓存的损坏文件也可能导致安装失败,先清理缓存再试:
pip cache purge pip install Pillow
如果这些方法都试过还是不行,可以告诉我你的具体Python版本和Windows系统版本,我再帮你排查~
备注:内容来源于stack exchange,提问作者amine mohamed




