安装PyAudio遇“Failed Building Wheel for PyAudio”错误求助

我之前在Mac上装PyAudio也踩过一模一样的坑——明明用Homebrew装了portaudio，还是卡在编译错误，从gcc报错到clang失败，折腾了好一阵。给你几个亲测有效的解决思路：

1. 手动指定portaudio路径安装 #

Homebrew安装的portaudio不在系统默认搜索路径里，pip编译PyAudio的时候找不到它。先查一下portaudio的安装位置：

brew info portaudio

输出里会显示类似/usr/local/Cellar/portaudio/19.7.0（Intel芯片）或者/opt/homebrew/Cellar/portaudio/19.7.0（M系列芯片）的路径。

然后用pip安装时手动指定头文件和库路径：

• Intel芯片用户：

pip install pyaudio --global-option='build_ext' --global-option='-I/usr/local/include' --global-option='-L/usr/local/lib'

• M系列芯片用户：

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

2. 检查并修复Xcode Command Line Tools #

clang编译失败很多时候是因为Xcode命令行工具没装全或者出了问题。先检查是否安装：

xcode-select --install

如果已经装了，试试重置一下：

xcode-select --reset

重启终端后再尝试安装PyAudio。

3. 用虚拟环境隔离依赖 #

系统自带的Python可能存在权限或路径冲突，建议创建一个虚拟环境再试：

# 创建虚拟环境
python3 -m venv pyaudio-env
# 激活虚拟环境
source pyaudio-env/bin/activate
# 再执行上面的pip安装命令

4. 用conda安装预编译包（最省心） #

如果pip编译始终有问题，试试用conda安装预编译好的PyAudio，不用自己折腾编译：

conda install -c conda-forge pyaudio

错误原因解释 #

你遇到的gcc/clang编译失败，本质是PyAudio在构建扩展模块时，找不到portaudio的头文件（.h）或库文件（.dylib），或者本地编译环境（比如Xcode工具）不完整。上面的方案要么帮pip定位到portaudio的位置，要么跳过编译直接用预编译包，应该能解决问题。

内容的提问来源于stack exchange，提问作者G-Slice