如何解决Python安装PyAudio时出现的Could not build wheels错误？

这个错误核心原因是PyAudio编译需要依赖PortAudio的开发文件，同时系统缺少gcc这类编译工具，导致无法构建wheel包。按以下对应系统操作即可解决：

Debian/Ubuntu 系列系统 #

• 先安装编译依赖和PortAudio开发包：

  sudo apt-get update
  sudo apt-get install gcc portaudio19-dev python3-dev
  

• 重新执行PyAudio安装命令：

  pip install pyaudio
  

CentOS/RHEL 系列系统 #

• 安装编译依赖和PortAudio开发包：

  sudo yum install gcc portaudio-devel python3-devel
  

• 再安装PyAudio：

  pip install pyaudio
  

Windows 系统 #

Windows不需要手动编译，直接用预编译wheel包安装更省心：

• 确认你的Python版本（比如3.10）和系统位数（64位），下载对应版本的PyAudio wheel包（文件名格式类似PyAudio-0.2.13-cp310-cp310-win_amd64.whl）
• 切换到下载目录，执行本地安装：

  pip install PyAudio-0.2.13-cp310-cp310-win_amd64.whl
  

  （注意替换成你实际下载的文件名）

macOS 系统 #

• 用Homebrew安装PortAudio依赖：

  brew install portaudio
  

• 然后安装PyAudio：

  pip install pyaudio
  

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