Mac系统安装mpi4py报错求助：无法编译MPI程序

核心问题 #

编译报错找不到mpi.h头文件，是因为系统未安装MPI开发库；另外你使用的apt-get是Linux系统的包管理命令，MacOS不支持，需用Homebrew或MacPorts这类Mac专属工具。

解决步骤 #

方案一：通过Homebrew安装OpenMPI（推荐） #

• 若未安装Homebrew，执行以下命令安装：

  /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
  

• 安装OpenMPI开发库：

  brew install openmpi
  

• 重新安装mpi4py：

  pip install mpi4py
  

方案二：通过MacPorts安装OpenMPI #

• 先安装MacPorts（前往官方网站下载安装包完成安装）
• 安装OpenMPI：

  sudo port install openmpi
  

• 重新安装mpi4py：

  pip install mpi4py
  

方案三：手动指定MPI路径（适用于上述方案失败的情况） #

如果自动检测路径失败，手动指定MPI的头文件和库路径：

pip install mpi4py --no-cache-dir --global-option=build_ext --global-option="-I/usr/local/include" --global-option="-L/usr/local/lib"

注：Homebrew默认安装路径为/usr/local/include和/usr/local/lib；若用MacPorts，路径改为/opt/local/include和/opt/local/lib

验证安装成功 #

执行以下命令验证MPI和mpi4py是否正常工作：

mpiexec -n 2 python -c "from mpi4py import MPI; print(f'Rank: {MPI.COMM_WORLD.rank}, Size: {MPI.COMM_WORLD.size}')"

若输出两行分别显示Rank 0/Size 2和Rank 1/Size 2，说明安装成功。

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