pip安装PyAudio提示找不到portaudio.h文件报错如何解决

错误原因 #

你的报错核心是fatal error C1083: Cannot open include file: 'portaudio.h': No such file or directory，即本地缺少PyAudio依赖的PortAudio音频库头文件，pip默认拉取源码编译时找不到对应依赖，导致编译失败。

解决方法（按简便程度排序） #

方法1：使用pipwin安装预编译包（推荐） #

不需要本地编译环境，自动匹配对应版本：

• 先安装pipwin工具：pip install pipwin
• 执行安装PyAudio命令：pipwin install pyaudio

注：如果使用虚拟环境，需要先激活对应虚拟环境再执行上述命令

方法2：手动安装预编译wheel包 #

如果方法1执行失败，可以手动安装对应版本的wheel文件：

• 先确认你的Python版本和架构：从日志可知你当前环境为Python 3.9 64位
• 下载对应版本的PyAudio预编译wheel文件后，执行命令安装：pip install 下载的wheel文件完整路径

方法3：从源码编译（仅适合有编译经验的用户） #

如果确实需要从源码编译安装：

• 先下载PortAudio官方开发包，将包内的头文件、静态库文件路径分别配置到系统编译搜索路径
• 再执行pip install pyaudio完成编译安装

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