安装balebot模块时遇Pillow依赖zlib缺失错误求助

问题描述 #

尝试执行pip install balebot或pip install pillow安装balebot（一款用于开发信使机器人的Python模块）时，Pillow安装环节失败，核心错误为编译Pillow源码所需的zlib头文件或库文件缺失，无法构建wheel包，进而导致balebot安装中断。关键错误信息如下：

The headers or library files could not be found for zlib,
a required dependency when compiling Pillow from source.

RequiredDependencyException: zlib

ERROR: Failed building wheel for pillow
Failed to build pillow
ERROR: Could not build wheels for pillow, which is required to install pyproject.toml-based projects

解决方案 #

方案1：直接安装预编译Pillow wheel包 #

跳过源码编译环节，下载与你的Python版本、系统架构匹配的Pillow预编译wheel文件（.whl格式），通过pip直接安装：

# 替换为你下载的wheel文件路径
pip install Pillow-xxx-cp311-cp311-win_amd64.whl

安装完成后，再执行pip install balebot即可。

方案2：补全zlib依赖与编译环境 #

1. 先安装基础编译工具：

   pip install setuptools wheel
   

   然后安装Visual Studio Build Tools，选择「Desktop development with C++」组件（包含编译所需的环境）。
2. 下载zlib开发包，解压后将其include目录路径添加到系统INCLUDE环境变量，lib目录路径添加到系统LIB环境变量。
3. 重新执行pip install pillow，完成后再安装balebot。

方案3：使用conda管理依赖（若已配置conda环境） #

conda会自动处理依赖项，无需手动配置编译环境：

conda install pillow
pip install balebot

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