第4章:Python环境搭建——安装Python与必要的库

说实话,很多初学者在环境搭建这一步就卡住了。我见过不少同学,代码写得挺好,结果因为Python版本不对、库装不上,折腾一整天。嗯,咱们今天就把这事一次性搞定。

4.1 安装Python——选对版本很重要

我个人习惯用Python 3.8到3.10之间的版本。为什么?因为PyQt5在这些版本上最稳定。我曾经试过Python 3.11,结果发现某些库的兼容性有问题,折腾了半天才搞定。

下载地址很简单:去python.org,找到Downloads,选你的操作系统。

安装时注意这几点:

  • 勾选"Add Python to PATH"——这个忘了勾,后面命令行里打python就没反应
  • 安装路径别用中文,也别有空格
  • 选"Customize installation",确保pip被勾上
⚠️ 我曾经踩过的坑: 系统里同时装了Python 2和Python 3,结果pip install装到了Python 2上。建议把老版本卸干净,或者用py -3.10这样的命令指定版本。

4.2 虚拟环境配置——隔离项目依赖

你想想看,一个项目用numpy 1.21,另一个用1.24,装在一起肯定打架。虚拟环境就是干这个的。

我推荐用venv,Python自带的,不用额外装东西。

# 创建虚拟环境
python -m venv spectrum_env

# 激活(Windows)
spectrum_env\Scripts\activate

# 激活(Mac/Linux)
source spectrum_env/bin/activate

# 退出
deactivate

激活后,命令行前面会出现(spectrum_env)的提示。这时候你装的库都只在这个环境里,不影响全局。

💡 我的小习惯: 每个项目建一个虚拟环境,名字就用项目名。这样换电脑时,把requirements.txt一拷,pip install -r requirements.txt就全回来了。

4.3 安装必要的库——numpy、matplotlib、PyQt5

咱们做频谱仪,说白了就靠这三个库:

库名 用途 安装命令
numpy 处理频谱数据、FFT计算 pip install numpy
matplotlib 绘制频谱图、余辉效果 pip install matplotlib
PyQt5 做界面、显示控件 pip install PyQt5

安装命令很简单,在激活的虚拟环境里执行:

pip install numpy matplotlib PyQt5

如果网速慢,可以用国内镜像:

pip install numpy matplotlib PyQt5 -i https://pypi.tuna.tsinghua.edu.cn/simple
🔍 验证安装: 打开Python交互环境,输入import numpy,没报错就说明装好了。我每次装完库都会这么测一下,省得后面写代码才发现问题。

4.4 IDE选择与调试——工欲善其事

IDE这块,我个人推荐两个:

  • VS Code——轻量、插件丰富,适合日常开发
  • PyCharm——功能全面,调试体验好,适合大型项目

我用VS Code比较多,配置起来也简单:

  1. 装Python插件(微软官方那个)
  2. Ctrl+Shift+P,选"Python: Select Interpreter"
  3. 找到你刚才创建的虚拟环境路径

调试小技巧:

  • 断点打在行号左边,点一下就行
  • 按F5开始调试,F10单步执行
  • 变量面板里能看到所有变量的当前值
⚠️ 我曾经犯过的错: 调试时发现import报错,检查了半天,结果发现IDE用的解释器是全局的Python,不是虚拟环境里的。记得每次新建项目都检查一下解释器路径。

4.5 快速测试——跑通第一个程序

环境搭好了,咱们写个简单程序验证一下:

import numpy as np
import matplotlib.pyplot as plt
from PyQt5.QtWidgets import QApplication, QLabel

# 测试numpy
data = np.array([1, 2, 3, 4, 5])
print("numpy测试通过:", data)

# 测试matplotlib
plt.plot(data)
plt.title("测试频谱显示")
plt.show()

# 测试PyQt5
app = QApplication([])
label = QLabel("环境搭建成功!")
label.show()
app.exec_()

能正常运行,说明你的环境已经准备好了。接下来咱们就可以正式开始做频谱仪了。

💡 我的建议: 把这段代码保存成test_env.py,以后换电脑或者重装系统,跑一遍就知道环境有没有问题。

好了,环境搭建就到这里。下一章咱们开始讲频谱仪的核心——FFT变换和实时数据处理。到时候你会看到,前面这些准备工作,都是值得的。