Mac系统已装PortAudio，pip安装PyAudio报错求助

云原生阿岚

2026-5-13

解决Mac上brew装PortAudio后pip安装PyAudio失败的问题

我之前也碰到过一模一样的坑！明明用brew装好了PortAudio，但pip安装PyAudio时就是触发clang编译错误，核心原因是pip找不到brew安装的PortAudio的头文件和库文件路径。试试下面的解决步骤：

第一步：确认PortAudio的安装路径
先执行这条命令查看PortAudio的安装信息：
```
brew info portaudio
```
输出里会有类似/usr/local/Cellar/portaudio/19.7.0的路径（版本号可能不同），把这个路径记下来，后面会用到。

第二步：指定路径安装PyAudio
用pip安装时手动指定PortAudio的include和lib路径，把刚才记下的路径替换到<PORTAUDIO_PATH>的位置：

pip install pyaudio --global-option='build_ext' --global-option='-I<PORTAUDIO_PATH>/include' --global-option='-L<PORTAUDIO_PATH>/lib'

举个实际例子，如果你的PortAudio路径是/usr/local/Cellar/portaudio/19.7.0，命令就是：

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

简化版（如果PortAudio链接到/usr/local）
因为brew通常会把PortAudio的文件链接到/usr/local目录，所以也可以直接用这条命令，省去找路径的步骤：
```
pip install pyaudio --global-option="build_ext" --global-option="-I/usr/local/include" --global-option="-L/usr/local/lib"
```
额外排查：确保Xcode命令行工具完整
如果还是报错，可能是clang的环境有问题，执行这条命令安装或更新Xcode命令行工具：
```
xcode-select --install
```