Windows 下安装 PyAudio 的完整教程：从报错到成功，一步一步搞定

目标关键词：Windows 下安装 PyAudio

PyAudio 是 Python 里用来做录音、播放音频、语音识别常见会用到的库。很多人第一次在 Windows 上安装它时，都会遇到失败，比如：

• pip install pyaudio 报错
• 找不到 portaudio 依赖
• 提示编译失败
• 32 位和 64 位版本不匹配
• Python 版本不兼容

这类问题很常见，原因不是你操作错了，而是 PyAudio 在 Windows 上不算“傻瓜式安装”，尤其是直接用 pip 安装时，系统经常缺少编译环境或依赖包。

下面我按新手能看懂的方式，把 Windows 下安装 PyAudio 的方法讲清楚，并给你最稳妥、最省事的解决方案。

---

一、先弄明白：为什么 PyAudio 在 Windows 上容易装失败

PyAudio 本身是 Python 包，但它底层依赖一个叫 PortAudio 的音频库。
在 Linux 和 MACOS 上，有时系统环境更容易配好；但在 Windows 上，很多情况下 pip 会尝试现编译，结果就容易报错。

常见原因有这几个：

1. 没有对应版本的预编译轮子包
2. Python 版本不匹配
3. 系统是 64 位，但装了 32 位包，或反过来
4. 没有安装 Visual C++ 编译环境
5. 直接 pip install pyaudio 时，pip 拉到的是源码包，不是可直接安装的 wheel 包

所以，Windows 上安装 PyAudio，最推荐的办法不是直接硬怼 pip，而是优先使用适合你 Python 版本和系统架构的 .whl 文件。

---

二、安装前先确认这 3 件事

在开始之前，先确认你的环境，避免走弯路。

1）确认 Python 版本

打开命令提示符 cmd，输入：

python --version

或者：

py --version

PyAudio 对某些较新的 Python 版本支持并不总是第一时间跟上，通常 Python 3.8、3.9、3.10、3.11 相对更稳。

如果你用的是特别新的版本，安装失败概率会更高。

---

2）确认系统位数

右键“此电脑” → “属性”，查看系统类型：

• 64 位操作系统
• 32 位操作系统

大多数现在的电脑都是 64 位，后面安装时必须和 Python 版本对应。

也可以在命令行输入：

python

进入 Python 后执行：

import platform
platform.architecture()

如果输出里显示 64bit，就说明当前 Python 是 64 位。

---

3）确认 pip 是否正常

输入：

pip --version

如果能显示版本号，就说明 pip 可用。
如果提示找不到命令，先把 Python 的环境变量配置好，或者直接用：

python -m pip --version

---

三、Windows 下安装 PyAudio 的推荐方法

方法一：使用 wheel 安装包，这是最稳的方式

这是 Windows 上最常用、最省事的方法。

第一步：先卸载旧的失败安装记录

如果你之前装过一次失败的，先执行：

pip uninstall pyaudio

如果提示没装过，可以忽略。

---

第二步：下载对应的 .whl 文件

你需要找到和以下信息匹配的 wheel 包：

• Python 版本
• Windows 位数
• Python 对应的编译版本标签

比如：

• cp310 = Python 3.10
• cp311 = Python 3.11
• win_amd64 = Windows 64 位
• win32 = Windows 32 位

举例来说，如果你是：

• Python 3.10
• 64 位 Windows

那就需要类似这种文件：

PyAudio‑0.2.13‑cp310‑cp310‑win_amd64.whl

如果你是：

• Python 3.9
• 64 位 Windows

那就是：

PyAudio‑0.2.13‑cp39‑cp39‑win_amd64.whl

---

第三步：安装下载好的 whl 文件

假设你已经把文件下载到桌面，先进入桌面目录，例如：

cd %USERPROFILE%\Desktop

然后执行：

pip install PyAudio-0.2.13-cp310-cp310-win_amd64.whl

如果你的文件名不同，就替换成你实际下载的文件名。

---

方法二：直接用 pip 安装，但要看环境是否支持

有些环境下直接运行：

pip install pyaudio

就能成功。
但如果失败，大概率会出现下面这些错误：

• Microsoft Visual C++ 14.0 or greater is required
• Failed building wheel for pyaudio
• error: command 'cl.exe' failed
• fatal error: portaudio.h: No such file or directory

如果是这种情况，就不要继续死磕直接安装了，优先改用 wheel 包安装。

---

四、如果直接安装失败，怎么处理

情况 1：报 “Microsoft Visual C++ 14.0 or greater is required”

这个报错说明系统缺少 C++ 编译环境。

解决办法：

安装 Microsoft Visual C++ Build Tools。

步骤如下：

1. 打开微软官方的 Visual Studio 下载页面
2. 下载 Build Tools for Visual Studio
3. 安装时勾选：
   • 使用 C++ 的桌面开发
   • MSVC
   • Windows 10/11 SDK
4. 安装完成后重启电脑
5. 再试一次：

pip install pyaudio

不过要注意，即使装了编译环境，也不一定保证成功，所以还是优先建议 wheel 包。

---

情况 2：报 “Failed building wheel for pyaudio”

这个错误通常意味着：

• 没有预编译包
• 依赖缺失
• Python 版本不兼容

解决办法：

直接改用 wheel 文件安装，不要强行源码编译。

---

情况 3：报 “No matching distribution found for pyaudio”

这说明 pip 没找到适合你当前环境的安装包。

解决办法：

检查这几个点：

• Python 版本是否太新
• 系统位数是否一致
• pip 是否升级到最新版本

先执行：

python -m pip install --upgrade pip

再试一次。

如果还是不行，下载对应 .whl 文件安装。

---

五、最稳的完整安装流程

下面给你一个适合大多数 Windows 用户的标准流程，照着做基本能成功。

第一步：查看 Python 版本

python --version

第二步：查看系统位数

确认是 64 位还是 32 位。

第三步：升级 pip

python -m pip install --upgrade pip

第四步：下载匹配的 PyAudio whl 包

文件名要和你的 Python 版本一致。

第五步：安装 whl

进入文件所在目录后执行：

pip install 文件名.whl

第六步：验证是否成功

输入：

python

进入交互模式后执行：

import pyaudio
print(pyaudio.__version__)

如果没有报错，并显示版本号，说明安装成功。

---

六、PyAudio 安装成功后怎么测试

安装好以后，建议马上做个简单测试，确认录音功能能不能正常用。

测试代码

import pyaudio

p = pyaudio.PyAudio()

print("可用音频设备数量：", p.get_device_count())

for i in range(p.get_device_count()):
    info = p.get_device_info_by_index(i)
    print(i, info.get('name'))

p.terminate()

如果能正常打印出设备列表，说明 PyAudio 工作正常。

---

七、常见坑位整理

1）Python 版本太新

有些 PyAudio 轮子包更新没那么快，Python 太新会找不到匹配包。
建议优先使用：

• Python 3.8
• Python 3.9
• Python 3.10
• Python 3.11

---

2）32 位和 64 位搞混

这个问题非常常见。

要保证：

• 64 位 Windows → 64 位 Python → 64 位 PyAudio wheel
• 32 位 Windows → 32 位 Python → 32 位 PyAudio wheel

一旦混用，很容易装失败或运行异常。

---

3）pip 装到了别的 Python 里

有些电脑装了多个 Python，结果 pip 和 python 不是同一个环境。

建议统一用：

python -m pip install pyaudio

这样能减少装错环境的概率。

---

4）命令行权限不够

如果提示权限问题，可以右键“命令提示符”或“Windows Terminal”，选择以管理员身份运行，再执行安装命令。

---

八、如果你是做语音识别，建议顺手装这些配套工具

很多人装 PyAudio，不是为了单独录音，而是为了做语音识别、麦克风采集、音频分析。
这时可以一起装一些常用依赖：

pip install numpy
pip install scipy
pip install sounddevice
pip install SpeechRecognition

其中：

• SpeechRecognition 常和 PyAudio 配合使用
• numpy、scipy 常用于音频处理
• sounddevice 有时能替代一部分录音场景

如果你只是做简单的麦克风输入，sounddevice 在某些场景下也更省心。

---

九、最推荐的新手方案

如果你完全不想折腾，直接按这个思路来：

1. 用 Python 3.10 或 3.11
2. 确认系统是 64 位
3. 升级 pip
4. 下载匹配的 PyAudio wheel 文件
5. 用 pip install xxx.whl 安装
6. 用 import pyaudio 测试

这套流程成功率最高。

---

十、总结：Windows 下安装 PyAudio 的核心思路

Windows 上安装 PyAudio，重点不是“反复执行 pip”，而是要先判断自己的环境，再选择正确的安装方式。

最佳安装顺序：

• 先确认 Python 版本
• 再确认系统位数
• 优先使用 .whl 预编译包
• 失败后再考虑 Visual C++ 编译环境
• 安装后用 import pyaudio 验证

一句话记住：

Windows 装 PyAudio，能用 wheel 就别硬编译；版本对了，基本一次成功。

如果安装过程中遇到报错，通常不是 PyAudio 本身坏了，而是 Python 版本、系统位数、依赖环境 这三项没有对齐。