You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

Windows系统下pip安装PyAudio报exit status 1缺失portaudio.h问题

Windows环境PyAudio安装报错解决方案

报错核心原因:本地缺少PyAudio依赖的PortAudio开发库头文件portaudio.h,即使安装了VC++编译工具也无法完成源码编译

方案1:直接安装预编译wheel包(推荐)

PyAudio官方未提供Python3.9+的官方预编译包,可通过适配Windows的预编译包工具直接安装,无需本地编译:

  • 先执行命令升级基础依赖:
pip install --upgrade pip wheel setuptools
  • 再安装Windows预编译包管理工具,自动匹配适配的PyAudio版本安装:
pip install pipwin
pipwin install PyAudio

方案2:手动源码编译安装(适合自定义配置场景)

如果需要从源码编译安装,提前配置PortAudio依赖即可:

  • 下载PortAudio的Windows开发包,解压到本地任意目录
  • 新建系统环境变量PORTAUDIO_PATH,值为你解压的PortAudio根目录路径
  • 把PortAudio目录下的include文件夹路径添加到系统INCLUDE环境变量,lib文件夹路径添加到系统LIB环境变量
  • 重新执行pip install PyAudio命令即可完成编译安装

安装验证

执行以下命令,无报错输出版本号即为安装成功:

python -c "import pyaudio; print(pyaudio.__version__)"

内容的提问来源于stack exchange,提问作者Hodjaev Azamat

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.04 05:42:04