要通过.whl文件完成sounddevice的安装，可参考以下流程：
一、前期准备
获取.whl文件：
前往 gitee.com/FIRC/pythonlibs_whl_mirror 或其他可信资源站点，下载适用于你系统的sounddevice的.whl包。注意核对Python版本与操作系统架构（如32位或64位）是否匹配。![[python]windows上通过whl文件安装sounddevice教程](https://img.php.cn/upload/article/001/503/042/175928504952461.jpg)
确认pip已安装：
pip是Python默认的包管理工具，通常随Python一同安装。可在命令行输入以下命令检查：
pip --version
若未安装，可通过如下命令进行安装并升级：
python -m ensurepip --upgrade
安装依赖库PortAudio：
由于sounddevice基于PortAudio运行，因此需预先安装该底层音频库。
- Windows系统：从PortAudio官网获取预编译的二进制文件并手动安装。
-
macOS系统：使用Homebrew工具安装，执行命令：
brew install portaudio
-
Linux系统（如Ubuntu）：利用系统包管理器安装开发包，例如：
sudo apt-get install portaudio19-dev
二、执行安装
打开命令行工具：
- Windows用户可使用
cmd或PowerShell； - macOS和Linux用户请打开终端程序。
进入.whl文件所在路径：
使用cd命令切换至你保存.whl文件的目录，例如：
cd Downloads
运行安装命令：
执行以下指令进行本地安装：
pip install sounddevice-x.x.x-py3-none-any.whl
请将sounddevice-x.x.x-py3-none-any.whl替换为你实际下载的文件名。
三、验证是否安装成功
导入模块测试：
启动Python环境，尝试导入模块：
import sounddevice as sd
列出音频设备信息：
运行以下代码查看当前系统的音频设备列表：
print(sd.query_devices())
判断安装结果：
若无报错信息，并能正常输出设备列表，则表明sounddevice已成功安装。
至此，你已完成通过.whl文件对sounddevice的安装配置。现在即可在Python项目中使用该库实现音频录制与播放功能。
立即学习“Python免费学习笔记（深入）”；
