安装pyproject.toml项目时pyzmq编译wheel失败求助

在执行python -m pip install -e .安装基于pyproject.toml的项目时，遇到报错：

could not build wheels for pyzmq, which is required to install pyproject.toml-based projects.

尝试pip install pyzmq==23.2.1等常规方案无效，问题可通过ipywidgets自定义小部件教程的项目构建步骤复现。

解决步骤： #

1. 安装系统级zeromq开发依赖
   pyzmq源码编译需要依赖系统的zeromq开发库，根据你的系统执行对应命令：

   • Ubuntu/Debian：

     sudo apt-get install libzmq3-dev
     

   • CentOS/RHEL：

     sudo yum install zeromq-devel
     

   • macOS（需先安装Homebrew）：

     brew install zeromq
     

2. 升级pip、wheel和setuptools
   旧版本工具可能存在兼容性问题，先升级：

   python -m pip install --upgrade pip wheel setuptools
   

3. 强制安装预编译版pyzmq
   跳过源码编译，直接使用官方预编译的wheel包：

   pip install --only-binary :all: pyzmq
   

4. 重新安装目标项目
   完成上述步骤后，再次执行项目安装命令：

   python -m pip install -e .
   

问题原因说明 #

pyzmq默认会尝试从源码编译生成wheel，但编译过程依赖系统中的zeromq开发库，若缺少这些依赖则编译失败，进而导致pyproject.toml项目无法完成安装。之前单独指定版本无效，大概率是因为仍在尝试源码编译而非使用预编译包，或系统依赖未补齐。

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