M1 Mac Python3.11下pip安装psychopy遇构建wheel依赖错误

问题根源 #

你之前设置的HDF5_DIR路径错误，指向了HDF5的安装脚本（HDF5-1.14.2-Darwin.sh），而非实际安装完成后的HDF5库目录，导致编译时找不到HDF5文件。

解决步骤 #

1. 用Homebrew安装HDF5（新手友好方式） #

M1 Mac推荐用Homebrew管理依赖，操作简单：

• 未安装Homebrew的话，先执行：

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

• 安装HDF5：

  brew install hdf5
  

2. 设置正确的HDF5环境变量 #

• 先获取HDF5的实际安装路径：

  brew --prefix hdf5
  

  会输出类似/opt/homebrew/opt/hdf5的路径
• 临时生效（当前终端有效，重启后失效）：

  export HDF5_DIR=$(brew --prefix hdf5)
  

• 永久生效：将环境变量写入zsh配置文件（M1 Mac默认shell为zsh）：

  echo 'export HDF5_DIR=$(brew --prefix hdf5)' >> ~/.zshrc
  

  执行后重启终端，或输入source ~/.zshrc让配置立即生效

3. 重新安装PsychoPy #

• 先升级pip到最新版本，规避兼容性问题：

  pip install --upgrade pip
  

• 执行安装命令：

  pip install psychopy
  

额外建议 #

如果安装仍有问题，可尝试创建Python虚拟环境隔离依赖：

# 创建虚拟环境
python3 -m venv psychopy-env
# 激活虚拟环境
source psychopy-env/bin/activate
# 再执行上述安装步骤

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