You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

Python3.11无法安装Pillow及相关包:无法构建Pillow Wheel

解决Python 3.11安装Pillow时的wheel构建失败问题

1. 安装系统依赖库

Pillow编译依赖系统层面的开发库,不同系统操作如下:

  • Debian/Ubuntu 系列:
    sudo apt-get update && sudo apt-get install python3-dev python3-setuptools gcc libjpeg-dev libpng-dev libtiff-dev libwebp-dev
    
  • RedHat/CentOS 系列:
    sudo yum install python3-devel gcc libjpeg-turbo-devel libpng-devel libtiff-devel libwebp-devel
    
  • Windows:
    直接安装适配Python 3.11的预编译wheel包,命令示例(需匹配系统位数):
    pip install Pillow-10.0.0-cp311-cp311-win_amd64.whl
    
  • macOS:
    先安装Xcode命令行工具,再安装依赖库:
    xcode-select --install
    brew install libjpeg libpng libtiff webp
    

2. 强制使用预编译wheel包

升级pip后,添加参数跳过本地编译,直接安装官方预编译包:

pip install --upgrade pip
pip install Pillow --only-binary :all:

3. 清理pip缓存

缓存的损坏文件可能导致安装异常,执行清理后重试:

pip cache purge

4. 指定兼容Python 3.11的Pillow版本

确保安装的Pillow版本支持Python 3.11,推荐安装最新稳定版:

pip install Pillow==10.0.0  # 10.x及以上版本适配Python3.11

5. 用虚拟环境隔离全局环境冲突

创建并激活专属虚拟环境后再安装,避免全局环境干扰:

python3.11 -m venv pillow-env
# Linux/macOS 激活环境
source pillow-env/bin/activate
# Windows 激活环境
pillow-env\Scripts\activate
pip install Pillow

内容的提问来源于stack exchange,提问作者Binyam Mulat

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.07.18 05:14:53