Mac系统安装PyAudio提示portaudio.h找不到该如何解决

报错根因 #

portaudio.h not found报错是因为pip编译PyAudio时，无法识别Homebrew安装的portaudio的头文件与链接库路径。

操作步骤 #

• 第一步：安装Xcode命令行工具（未安装时执行）

xcode-select --install

弹出安装提示后按照指引完成安装即可。

• 第二步：确认portaudio的安装路径

brew --prefix portaudio

执行后会输出路径，Intel芯片Mac一般为/usr/local/opt/portaudio，M系列芯片Mac一般为/opt/homebrew/opt/portaudio，以下步骤用${PORTAUDIO_PATH}指代该输出路径。

• 第三步：指定路径安装PyAudio

export CPATH="${PORTAUDIO_PATH}/include"
export LIBRARY_PATH="${PORTAUDIO_PATH}/lib"
python3 -m pip install pyaudio

备选方案 #

如果上述方案仍然失败，可直接在pip安装命令中指定编译参数：

python3 -m pip install --global-option="build_ext" --global-option="-I${PORTAUDIO_PATH}/include" --global-option="-L${PORTAUDIO_PATH}/lib" pyaudio

其他注意事项 #

如果提示pip版本过低，可先执行升级操作：

python3 -m pip install --upgrade pip

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