VS Code中speech_recognition无法运行，报PyAudio not found错误求助
2026-10-3
PyAudio缺失报错解决方案
你遇到的报错信息如下：
raise AttributeError("Could not find PyAudio; check installation") AttributeError: Could not find PyAudio; check installation
该报错由speech_recognition库的麦克风输入功能依赖PyAudio库，而当前Python环境未正确安装PyAudio导致，可按以下步骤解决：
1. 基础安装尝试
首先确认你已经激活了VS Code当前项目对应的Python环境（若使用虚拟环境未激活，安装到全局环境会导致项目无法识别），直接执行官方安装命令：
pip install pyaudio
2. 直接安装失败的分系统处理方案
如果第一步执行后出现编译报错，按你使用的操作系统对应处理：
Windows系统
- 先安装wheel打包工具：
pip install wheel - 搜索Unofficial Windows Binaries for Python Packages站点，下载和你Python版本、系统架构匹配的PyAudio预编译wheel安装包
- 进入wheel包保存的文件夹，执行安装命令：
pip install 下载的wheel包完整文件名
MacOS系统
- 先通过Homebrew安装底层依赖portaudio：
brew install portaudio - 再执行pip安装：
pip install pyaudio
Linux（Debian/Ubuntu发行版）
- 先安装portaudio开发依赖：
sudo apt-get install portaudio19-dev python3-pyaudio - 再执行pip安装：
pip install pyaudio
3. 验证安装结果
- 执行
pip list命令，检查输出列表中是否存在PyAudio条目 - 运行以下测试代码确认功能正常：
import speech_recognition as sr r = sr.Recognizer() with sr.Microphone() as source: print("麦克风适配正常，问题已解决")
如果没有抛出缺失PyAudio的报错，就说明修复完成。
内容的提问来源于stack exchange，提问作者Aryan Tiwari
相关产品推荐
相关产品推荐
