如何修复 PyAudio、PortAudio 的安装问题：“致命错误 C1083：无法打开包含文件：‘portaudio.h’：没有此文件或目录”
- 2025-01-17 09:22:00
- admin 原创
- 230
问题描述：
我在安装 PyAudio 和 portaudio 时遇到问题。
当我这样做时，python -m pip install pyaudio我收到此错误：
src/_portaudiomodule.c(29): fatal error C1083: Cannot open include file: 'portaudio.h': No such file or directory
error: command 'C:\\Program Files (x86)\\Microsoft Visual Studio\\2017\\Community\\VC\\Tools\\MSVC\\14.14.26428\\bin\\HostX86\\\cl.exe' failed with exit status 2
----------------------------------------
Command ""C:UsersThis PCAppDataLocalProgramsPythonPython37-32python.exe" -u -c "import setuptools, tokenize;__file__='C:\\Users\\THISPC~1\\AppData\\Local\\Temp\\pip-install-3ock7jqh\\pyaudio\\setup.py';f=getattr(tokenize, 'open', open)(__file__);code=f.read().replace('
', '
');f.close();exec(compile(code, __file__, 'exec'))" install --record C:UsersTHISPC~1AppDataLocalTemppip-record-14pe9p6yinstall-record.txt --single-version-externally-managed --compile" failed with error code 1 in C:UsersTHISPC~1AppDataLocalTemppip-install-3ock7jqhpyaudio\n因此，在查看该错误后，我发现我需要安装 portaudio。所以我安装了python -m pip install portaudio，但出现了以下错误：
Collecting portaudio
Could not find a version that satisfies the requirement portaudio (from versions: )
No matching distribution found for portaudio
我现在不知道下一步该去哪里。
解决方案 1：
尝试一下，以管理员身份运行 CMD 并运行以下命令：
pip install pipwin
pipwin install pyaudio
解决方案 2：
portaudio不是一个 Python 包，它是一个完全独立于 Python 的 C 库，因此您无法通过 安装它pip。
请参阅PortAudio网站以获取有关在您的平台上获取和安装它的官方方法的详细信息。
据我所知，在 Windows 上获取它的官方方法是下载源代码，然后按照教程中的说明自行编译。您可能希望使用与 Python C 扩展相同的编译器来构建它，尽管我不确定这是否是必需的。
或者，如果您在 Windows 上使用第三方包管理器（如Chocolatey），则很有可能可以安装 PortAudio。
或者，如果你对 Python 使用 Anaconda 或 Miniconda，conda包管理器知道如何安装 Python 包所依赖的非 Python 包，包括portaudio。
最后，似乎有许多人提供非官方的预编译的 Windows PortAudio 二进制文件。如果您搜索“portaudio windows 二进制文件”或“portaudio windows 预编译”，您会找到很多。我不知道这些文件经过了多少测试、是否最新等。
如果你正在使用 Anaconda/Miniconda，那么一开始就应该使用conda install pyaudio而不是。你实际上应该只对或上不可用的包使用。pip install pyaudio`pipcondaconda-forge`
如果你尚未设置conda-forge，你可能需要先进行设置：
conda config --add channels conda-forge
然后，这应该是你所需要的全部：
conda install pyaudio
pip与假设您已正确安装的软件包不同portaudio，该conda软件包将自动portaudio作为依赖项安装pyaudio，或者告诉您无法安装的原因。
解决方案 3：
官方的 PyAudio 0.2.11 不支持 Python 3.7+，尝试安装会导致错误C1083: Cannot open include file: 'portaudio.h'。
但是， PyAudio有非官方版本支持 3.7+。
如果您使用的是官方版本，则必须使用 Python 3.6 和 PyAudio 0.2.11。
请参阅http://people.csail.mit.edu/hubert/pyaudio/
解决方案 4：
在 Ubuntu 发行版上，你可以先运行
sudo apt install portaudio19-dev
然后再次使用 pip 重新安装 pyaudio。
解决方案 5：
如果您在尝试使用 pipwin 安装时遇到错误，则必须通过 python 运行它，因为 Windows 无法识别 pipwin（至少对我来说）
pip install pipwin
python -m pipwin install pyaudio
解决方案 6：
我在 python 3.6.x 上安装了 pyaudio，没有问题，但在更高版本上无法正常工作。
py -m pip install pyaudio
在 3.6.x 或更早版本上运行良好。
解决方案 7：
你可以使用它来安装 Anaconda install pyaudio。你必须将 Anaconda 添加到路径中。安装 Anaconda 并添加到路径后，在命令提示符 [cmd] 中输入 conda install pyaudio。然后 whala
解决方案 8：
如果您正在使用 anaconda，那么这个问题是因为您的版本没有升级。要升级所有软件包，只需在终端中运行以下命令。
conda 更新--all
解决方案 9：
使用以下命令
pip install pipwin
pipwin refresh
pipwin install pyaudio
解决方案 10：
对于已将 pip 升级到 23.1 以上版本的人，该选项--install-option已被删除。应改用该--config-settings选项。该命令现在在 Mac 上如下所示：
$ pip install pyaudio --config-settings="--global-option=build_ext" --config-settings="--global-option=-I/opt/local/include" --config-settings="--global-option=-L/opt/local/lib"
调整系统的-I（包含路径）和（库路径）。在 Linux 上，它通常以 为前缀。-L`/usr/local`
解决方案 11：
您可以Portaudio安装
pip install port audio
你可能还需要
pip install ConfigParser
如果可行请告诉我。
