树莓派安装PyAudio后仍报ModuleNotFoundError问题求助

排查方向和解决步骤 #

1. 检查Python环境是否匹配 #

树莓派常存在多套Python环境共存的情况，系统apt安装的python3-pyaudio是给默认系统Python 3用的，但你当前运行的可能是虚拟环境、conda环境或自行编译的Python，自然找不到对应包。

• 先确认当前使用的Python路径：

  which python3
  

• 再查看系统PyAudio的安装位置：

  ls /usr/lib/python3/dist-packages/ | grep pyaudio
  

• 如果环境不匹配，要么切换到系统默认Python，要么给当前环境重新安装：
  • 用对应版本的pip安装（确保pip与Python版本对应）：

    python3 -m pip install pyaudio
    

  • 若pip安装失败，先装依赖再尝试：

    sudo apt install portaudio19-dev python3-pip
    python3 -m pip install pyaudio
    

2. 排查权限问题 #

偶尔会出现普通用户无法读取系统安装包的情况，先以sudo权限运行Python测试：

sudo python3

在交互界面输入import pyaudio，如果能成功导入，就是权限问题，给包目录添加读取权限：

sudo chmod -R o+r /usr/lib/python3/dist-packages/PyAudio*

3. 重装修复损坏的安装包 #

如果安装过程中文件损坏，卸载干净后重新安装：

sudo apt purge python3-pyaudio
sudo apt autoremove
sudo apt install python3-pyaudio

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