使用pip install baselines时mpi4py Wheel构建失败问题求助

问题场景 #

在Mac Catalina系统、13英寸2019款带双雷雳3端口的MacBook Pro上，使用PyCharm执行pip install baselines时，因mpi4py编译失败导致安装终止，错误信息如下：

ERROR: Failed building wheel for mpi4py
Building wheel for zmq (setup.py) ... done
Created wheel for zmq: filename=zmq-0.0.0-py3-none-any.whl size=1264 sha256=be7f6ab763266c2291f5ca7998e3ad24e48a4e85c04a2aa09a7fd5531823ae5b
Stored in directory: /Users/mac/Library/Caches/pip/wheels/4d/41/3a/bfd4dafaf1c20a4d08ff78bfcab77fcc4cf98e97c7941ce77a
Successfully built baselines zmq
Failed to build mpi4py
ERROR: Could not build wheels for mpi4py, which is required to install pyproject.toml-based projects

解决方案 #

mpi4py编译失败的核心原因是本地缺少MPI运行环境，按以下步骤解决：

1. 安装OpenMPI环境
   打开终端（或PyCharm内置终端），通过Homebrew安装OpenMPI：

brew install openmpi

若未安装Homebrew，可通过官方脚本完成安装

2. 手动指定MPI路径安装mpi4py
   单独安装mpi4py时，指定OpenMPI的安装路径（Intel芯片Mac默认路径为/usr/local/opt/openmpi）：

pip install mpi4py --no-binary :all: --install-option="--mpi=/usr/local/opt/openmpi"

3. 重新安装baselines
   mpi4py安装成功后，再次执行baselines安装命令：

pip install baselines

注意事项 #

• 确保操作在PyCharm对应的项目虚拟环境中执行，避免全局环境冲突
• 若仍出现编译错误，可尝试更新pip到最新版本：pip install --upgrade pip

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