Windows系统Django项目安装Pillow失败：zlib依赖缺失求助

核心原因 #

Windows系统默认缺少编译Python扩展所需的C语言构建工具和依赖库（比如zlib），导致Pillow、MySQL客户端这类需要编译的包无法生成wheel。

具体解决步骤 #

1. 安装Microsoft Visual C++构建工具 #

• 打开控制面板 -> 程序和功能，查看是否已安装Microsoft Visual Studio Build Tools（包含C++编译组件）。
• 如果未安装，下载对应版本的构建工具（Python 3.8+建议选VS 2019及以上），安装时勾选**"Desktop development with C++"**组件，确保包含MSVC编译器、Windows SDK等核心工具。

2. 直接安装预编译的Pillow wheel包 #

跳过源码编译，用官方预编译包：

pip install pillow --only-binary :all:

这个命令会强制pip下载预编译好的wheel文件，避免本地编译环节。

3. 手动指定zlib依赖（可选） #

如果预编译方式仍有问题，可手动配置zlib路径：

• 下载匹配系统位数的zlib预编译库，解压到本地目录（比如C:\zlib）。
• 执行安装命令前设置环境变量：

  set ZLIB_ROOT=C:\zlib
  pip install pillow
  

4. MySQL客户端同类问题的解决 #

同样用预编译包规避编译：

pip install mysqlclient --only-binary :all:

若仍失败，确保已安装MySQL Connector/C，并将其bin目录添加到系统环境变量PATH中。

总结 #

这类问题本质是Windows缺少Python扩展编译的基础环境，优先用预编译wheel包跳过编译步骤；若必须源码编译，再补全C++构建工具和对应依赖库。

内容的提问来源于stack exchange，提问作者Prathmesh Borse