第3章：Python音频处理环境搭建

好，咱们开始动手了。这一章我带你搭一个能跑语音信号处理的环境。说实话，很多初学者在这上面栽过跟头——库版本冲突、依赖装不上、跑起来报错。我当年也踩过不少坑，所以这一章我会把每一步都讲清楚。

3.1 为什么需要虚拟环境？

你想想看，一个项目可能用librosa 0.8，另一个项目可能用0.10。如果全装到系统Python里，早晚会打架。虚拟环境就是给每个项目一个独立的“小房间”，互不干扰。

我个人习惯用venv，Python 3.3以后自带的，不用额外装。当然也有人用conda，但我觉得venv更轻量。

3.2 创建虚拟环境

打开终端，找个你喜欢的目录，执行：

# 创建虚拟环境，名字叫 audio_env
python3 -m venv audio_env

# 激活环境（Windows）
audio_env\Scripts\activate

# 激活环境（Mac/Linux）
source audio_env/bin/activate

激活成功后，终端前面会出现 (audio_env) 的提示。嗯，看到这个就说明你已经在虚拟环境里了。

3.3 安装核心库

接下来装我们需要的库。我按依赖顺序来，这样不容易出问题。

3.3.1 numpy 和 scipy

这两个是科学计算的基础。librosa依赖它们，所以先装：

pip install numpy scipy

装完后可以验证一下：

python -c "import numpy; print(numpy.__version__)"

我建议numpy版本不低于1.21，scipy不低于1.7。太老的版本有些新函数用不了。

3.3.2 soundfile

这个库用来读写音频文件。它底层依赖libsndfile，所以Windows用户可能需要装个预编译包：

pip install soundfile

如果报错，试试：

pip install soundfile --only-binary :all:

3.3.3 matplotlib

画图用的。语音信号处理里经常要看波形、频谱图：

pip install matplotlib

装完后测试：

python -c "import matplotlib; print('ok')"

3.3.4 librosa

这是重头戏。librosa是音频分析的神器，很多功能都封装好了：

pip install librosa

这个过程可能会有点慢，因为librosa依赖比较多。如果网络不好，可以加个国内镜像：

pip install librosa -i https://pypi.tuna.tsinghua.edu.cn/simple

3.4 完整安装脚本

我一般写个requirements.txt，方便以后复现：

numpy>=1.21.0
scipy>=1.7.0
soundfile>=0.12.0
matplotlib>=3.5.0
librosa>=0.9.0

然后一键安装：

pip install -r requirements.txt

3.5 验证环境

装完了，咱们写个小脚本验证一下。我建议你新建一个 test_env.py：

import numpy as np
import scipy.signal as signal
import soundfile as sf
import matplotlib.pyplot as plt
import librosa

# 生成一个1kHz的正弦波，持续1秒
fs = 16000  # 采样率
t = np.linspace(0, 1, fs)
x = np.sin(2 * np.pi * 1000 * t)

# 保存为wav文件
sf.write('test.wav', x, fs)

# 用librosa读取
y, sr = librosa.load('test.wav', sr=None)
print(f'采样率: {sr} Hz')
print(f'信号长度: {len(y)} 个采样点')

# 画个波形图
plt.figure(figsize=(10, 4))
plt.plot(y[:200])  # 只画前200个点
plt.title('1kHz正弦波（前200个采样点）')
plt.xlabel('采样点')
plt.ylabel('幅度')
plt.grid(True)
plt.savefig('test_waveform.png')
plt.show()

print('环境搭建成功！所有库都正常工作。')

运行它：

python test_env.py

如果看到波形图弹出来，终端打印了采样率和信号长度，那就说明环境没问题了。

3.6 常见问题与避坑

我整理了几个我实际遇到过的问题：

问题	原因	解决方法
librosa装不上	依赖的llvmlite版本冲突	先装llvmlite：pip install llvmlite==0.39.1
soundfile报错“libsndfile not found”	缺少底层库	Windows装预编译包，Mac用brew install libsndfile
matplotlib中文乱码	缺少中文字体	设置字体：plt.rcParams['font.sans-serif'] = ['SimHei']
numpy版本过高导致兼容问题	某些旧库不支持新版numpy	固定版本：numpy==1.23.5

3.7 环境导出与复现

环境配好了，记得导出依赖列表：

pip freeze > requirements.txt

以后换机器或者给别人用，直接：

python -m venv new_env
source new_env/bin/activate
pip install -r requirements.txt

搞定。这样你的实验就能复现了，这在工程里非常重要。

3.8 本章小结

这一章我们搭好了Python音频处理环境。说白了就是三步：建虚拟环境、装库、验证。别嫌麻烦，环境搭好了，后面写代码才顺畅。

下一章我们会开始真正的音频处理——读取音频文件、分析它的基本属性。到时候这些库就派上用场了。