安装PyAudio时出现Could not build wheels错误，求原因及解决办法

错误原因 #

• 缺少PyAudio编译必需的系统依赖库（核心是PortAudio），PyAudio基于PortAudio开发，没有这个库就没法构建wheel
• Python环境缺少编译工具链（比如gcc、make、C++编译器等），源码编译wheel必须依赖这些工具
• 对应Python版本/系统的预编译wheel包不存在，pip只能尝试从源码编译，但编译环境不达标导致失败

解决方法 #

Windows系统 #

• 优先用预编译wheel安装：找和你Python版本、系统位数匹配的PyAudio wheel文件（比如Python3.11+64位就找PyAudio-0.2.13-cp311-cp311-win_amd64.whl），然后执行pip install 下载的文件名.whl
• 若要源码编译：先安装Microsoft Visual C++ Build Tools，勾选「Desktop development with C++」组件，安装完成后再运行pip install pyaudio

macOS系统 #

1. 先通过Homebrew安装PortAudio依赖：

   brew install portaudio
   

2. 再安装PyAudio：

   pip install pyaudio
   

Linux系统（Ubuntu/Debian为例） #

1. 安装编译依赖和PortAudio：

   sudo apt-get install portaudio19-dev python3-dev
   

2. 执行PyAudio安装：

   pip install pyaudio
   

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