M1芯片Mac安装PyAudio时出现Failed building wheel错误求助

问题根源 #

编译报错fatal error: 'Python.h' file not found的核心原因：

1. pyenv安装的Python 3.9-dev缺少开发头文件，导致编译扩展时找不到必要的Python接口文件
2. M1架构下brew的portaudio默认安装路径是/opt/homebrew，但编译时默认指向x86架构的/usr/local，路径不匹配

解决步骤 #

• 安装Xcode命令行工具（编译依赖必备）：

  xcode-select --install
  

• 卸载现有pyenv的3.9-dev，重新安装并启用框架模式（确保包含开发头文件）：

  pyenv uninstall 3.9-dev
  env PYTHON_CONFIGURE_OPTS="--enable-framework" pyenv install 3.9-dev
  

• 激活你的虚拟环境后，指定portaudio的正确路径安装PyAudio：

  pip install --global-option='build_ext' --global-option='-I/opt/homebrew/include' --global-option='-L/opt/homebrew/lib' PyAudio
  

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