安装Pillow时遭遇zlib依赖缺失错误，请求技术支持

云上老周

2026-6-25

解决Pillow编译时找不到zlib头文件/库的问题

编译Pillow源码时出现zlib相关错误，核心原因是系统缺少zlib的开发依赖包，和Python或虚拟环境本身无关，以下是不同系统的解决步骤：

Debian/Ubuntu 系列 Linux

安装zlib开发包：

sudo apt update && sudo apt install zlib1g-dev

激活虚拟环境后重新执行安装：
```
python -m pip install Pillow
```

CentOS/RHEL 系列 Linux

安装zlib开发依赖：
```
sudo yum install zlib-devel
```
回到虚拟环境重新安装Pillow：
```
python -m pip install Pillow
```

macOS

用Homebrew安装zlib：
```
brew install zlib
```

指定zlib路径编译安装Pillow：

python -m pip install Pillow --global-option=build_ext --global-option="-I$(brew --prefix zlib)/include" --global-option="-L$(brew --prefix zlib)/lib"

Windows

先更新pip到最新版本，确保能优先下载预编译wheel包：
```
python -m pip install --upgrade pip
```
重新安装Pillow：
```
python -m pip install Pillow
```
若仍报错，手动下载与你的Python版本、系统架构匹配的Pillow wheel包，本地安装：
```
python -m pip install path/to/Pillow-xxx.whl
```