错误：无法在 Python 中为 pyaudio 构建轮子

作者

错误：无法在 Python 中为 pyaudio 构建轮子

ERROR: Could not build wheels for pyaudio in Python

要解决错误“Could not build wheels for pyaudio”，请运行
pip install --upgrade pip命令升级您的pip版本，为您的操作系统安装先决条件，然后重新运行该pip install PyAudio
命令。

python错误无法为pyaudio构建轮子

壳
ERROR: Failed building wheel for pyaudio
Failed to build pyaudio
ERROR: Could not build wheels for pyaudio, which is required to install pyproject.toml-based projects

首先，如果您使用的是 Linux，请确保您具备
pyaudio.

壳
sudo apt install build-essential portaudio19-dev python3.10-dev
pip install pyaudio
portaudio是 的先决条件pyaudio，因此如果缺少，则会引发错误。 portaudio

如果您使用的是 macOS，请尝试使用brew安装包。

壳
brew install portaudio
brew link --overwrite portaudio
pip install pyaudio

如果你在 macOS 上，你还必须portaudio在安装
pyaudio.

您可以在pyaudio 的 pypi 页面中阅读有关先决条件的更多信息
。

如果您使用的是 Windows，该python -m pip install pyaudio命令会安装包含 PortAudio 的预编译 PyAudio 库。

如果您使用 anaconda，请尝试使用conda.

壳
conda install -c anaconda pyaudio

错误的最常见原因是具有过时的版本pip。

以下是pip在所有操作系统上升级的命令。

哪个命令有效取决于您的操作系统和 Python 版本。

壳
# 👇️ if you have pip already installed
pip install --upgrade pip

# 👇️ if your pip is aliased as pip3 (Python 3)
pip3 install --upgrade pip

# 👇️ if you don't have pip in your PATH environment variable
python -m pip install --upgrade pip

# 👇️ if you don't have pip in your PATH environment variable
python3 -m pip install --upgrade pip

# 👇️ if you have easy_install
easy_install --upgrade pip

# 👇️ if you get a permissions error
sudo easy_install --upgrade pip

# 👇️ if you get a permissions error when upgrading pip
pip install --upgrade pip --user

# 👇️ upgrade pip scoped to the current user (if you get permissions error)
python -m pip install --user --upgrade pip
python3 -m pip install --user --upgrade pip

# 👇️ Installing directly from get-pip.py (MacOS and Linux)
curl https://bootstrap.pypa.io/get-pip.py | python

# 👇️ if you get permissions issues
curl https://bootstrap.pypa.io/get-pip.py | sudo python

# 👇️ alternative for Ubuntu/Debian
sudo apt-get update && apt-get upgrade python-pip

# 👇️ alternative for Red Hat / CentOS / Fedora
sudo yum install epel-release
sudo yum install python-pip
sudo yum update python-pip

现在pip已经升级，尝试运行pip install PyAudio命令。

壳
pip install PyAudio
pip3 install PyAudio


python -m pip install PyAudio
python3 -m pip install PyAudio

# 👇️ alternative for Debian(Ubuntu)
sudo apt install python3-pyaudio

如果错误未解决，请同时升级setuptools和wheel软件包。

壳
pip install --upgrade setuptools wheel

pip3 install --upgrade setuptools wheel

python3 -m pip install --upgrade setuptools wheel

升级后尝试重新运行该pip install命令。setuptoolswheel

如果这没有帮助，请尝试使用该
选项运行pip install命令。--upgrade

壳
pip install PyAudio --upgrade
pip3 install PyAudio --upgrade

python -m pip install PyAudio --upgrade
python3 -m pip install PyAudio --upgrade

如果错误未解决，请尝试安装带有
--no-cache-dir禁用缓存选项的软件包。

壳
pip install PyAudio --no-cache-dir
pip3 install PyAudio --no-cache-dir

如果这没有帮助，请使用该--pre选项来包括包的预发布和开发版本。

壳
pip install PyAudio --pre
pip3 install PyAudio --pre

python -m pip install PyAudio --pre
python3 -m pip install PyAudio --pre

该--pre选项使其pip包含包的预发布和开发版本。默认情况下pip只查找稳定版本。

这有时会有所帮助，因为包的预发布版本可能适用于您的 Python 版本。 wheel

如果错误未解决，请尝试运行带选项的pip install命令
。--no-use-pep517

壳
pip install --no-use-pep517 PyAudio
pip3 install --no-use-pep517 PyAudio

python -m pip install --no-use-pep517 PyAudio
python3 -m pip install --no-use-pep517 PyAudio

如果这没有帮助，请尝试安装另一个版本的PyAudio.

pip install package==您可以通过运行命令来检查软件包的可用版本
。

壳
pip install PyAudio==

pip 列出包的所有可用版本

输出包含包的所有版本的元组，从最旧的版本到最新的版本。

选择另一个版本的包并尝试安装它。这是一个例子。

壳
pip install PyAudio==0.2.11
pip3 install PyAudio==0.2.11

如果这没有帮助，请尝试创建一个虚拟环境。

创建虚拟环境

要解决“Could not build wheels for pyaudio”错误：

  1. 创建一个虚拟环境。
  2. 激活虚拟环境。
  3. 在虚拟环境处于活动状态的情况下运行pip install命令。
壳
# 👇️ use correct version of Python when creating VENV
python3 -m venv venv

# 👇️ activate on Unix or MacOS
source venv/bin/activate

# 👇️ activate on Windows (cmd.exe)
venv\Scripts\activate.bat

# 👇️ activate on Windows (PowerShell)
venv\Scripts\Activate.ps1

# 👇️ install the specific package in the virtual environment
pip install PyAudio

如果该python3 -m venv venv命令不起作用，请尝试以下 2 个命令：

  • python -m venv venv
  • py -m venv venv

确保根据您的操作系统和 shell 使用正确的命令来激活您的虚拟环境。

您的虚拟环境将使用用于创建它的 Python 版本。

检查包是否支持您的 Python 版本

当您尝试安装的包不适wheels用于您的 Python 版本时，有时会导致错误“错误：无法为 pyaudio 构建轮子”。

您可以使用命令检查您的 Python 版本python --version。

壳
python --version

检查 python 版本

您可以在包的 pypi 页面的下载文件部分检查包是否具有适用于特定 Python 版本的轮子。

例如，cp310“Built Distributions”下的文件名表示特定操作系统支持 Python 3.10 版。

如果这些.whl文件不适用于您的 Python 版本，您可以下载旧版本。

如果包不支持最新的 Python 版本，您可以下载包支持的特定 Python 版本。

“寻找特定版本”表中提供了不同的版本
。

安装特定的python版本

如果出现提示，请确保勾选以下选项：

  • 为所有用户安装启动器（推荐）
  • 将 Python 添加到 PATH（这会将 Python 添加到您的 PATH 环境变量）

尝试在详细模式下运行 pip install

如果这些建议都没有帮助，请尝试pip install在详细模式下运行命令。

壳
pip install PyAudio -vvv

pip3 install PyAudio -vvv

python -m pip install PyAudio -vvv

该-v选项代表详细模式，最多可以使用 3 次。

当pip install命令以详细模式运行时，命令会显示更多输出以及错误发生的方式。

结论

要解决错误“Could not build wheels for pyaudio”，请运行
pip install --upgrade pip命令升级您的pip版本，为您的操作系统安装先决条件，然后重新运行该pip install PyAudio
命令。

–