Mac M1环境安装eTraGo失败：pyproj Wheel构建错误求助

问题场景 #

在Mac M1设备、Python 3.10虚拟环境中安装eTraGo包时，触发以下编译错误：

note: This error originates from a subprocess, and is likely not a problem with pip.
ERROR: Failed building wheel for pyproj
Failed to build pyproj
ERROR: Could not build wheels for pyproj, which is required to install pyproject.toml-based projects

可行解决步骤 #

• 先通过Homebrew安装pyproj编译所需的系统依赖

  brew install proj geos
  

• 设置环境变量，让pip能定位到依赖库路径

  export PROJ_DIR=$(brew --prefix proj)
  export GEOS_DIR=$(brew --prefix geos)
  

• 激活虚拟环境后，先单独安装pyproj，再安装eTraGo

  source your_venv/bin/activate
  pip install pyproj
  pip install eTraGo
  

• 若上述步骤仍失败，尝试指定适配M1+Python3.10的pyproj版本

  pip install pyproj==3.5.0
  

补充说明 #

Mac M1的ARM架构编译C扩展包时，常需显式指定系统依赖路径。通过Homebrew安装的proj会提供完整编译环境，设置环境变量后pip可正确找到头文件与库文件完成编译。

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