2. 开发环境搭建:Python环境安装、PyCharm配置、相关库安装

好,咱们正式开始动手了。做电机控制上位机,第一步就是把开发环境搭起来。这步看着简单,但我见过太多人卡在这里——库装不上、版本冲突、PyCharm死活认不到解释器。别急,我一步步带你走,保证稳。

2.1 Python环境安装

Python版本怎么选?我个人习惯用Python 3.8或3.9。为什么?因为PyQt5和pySerial对这两个版本支持最稳定。Python 3.10以上有些库的二进制包还没跟上,你装起来会多不少麻烦。

注意:别装Python 3.12!我上个月帮一个学员排查问题,他装了3.12,结果PyQt5装不上,折腾了两小时。最后换回3.9,五分钟搞定。

安装步骤很简单:

  1. 去Python官网下载对应版本(Windows选Windows installer 64-bit)
  2. 安装时记得勾选「Add Python to PATH」——这个忘了后面有你哭的
  3. 一路Next,搞定

装完后验证一下。打开命令行(Win+R输入cmd),敲:

python --version
pip --version

如果看到版本号,说明装好了。没看到?多半是PATH没加,手动加一下环境变量就行。

2.2 PyCharm配置

编辑器我推荐PyCharm Community版,免费够用。专业版那些功能做上位机用不上。

安装完PyCharm,第一件事是配置解释器。你想想看,PyCharm默认用的可能是系统Python,但咱们最好创建一个虚拟环境——这样项目之间不打架。

操作路径:

  1. 打开PyCharm,点「File」→「Settings」→「Project: xxx」→「Python Interpreter」
  2. 点齿轮图标 → 「Add」→ 选「Virtualenv Environment」
  3. 位置选项目根目录,Base interpreter选你刚装的Python 3.9
  4. 点OK,等它创建完
小技巧:虚拟环境建好后,你会在项目目录下看到一个venv文件夹。以后所有库都装在这个环境里,删项目时直接删文件夹,干干净净。

嗯,这里要注意一点:如果你用中文路径,PyCharm有时候会抽风。我建议项目路径全用英文,比如 D:/MotorMonitor。我在项目中遇到过因为中文路径导致pySerial读取串口数据乱码的坑,排查了半天才发现是路径问题。

2.3 相关库安装

咱们这个项目需要三个核心库:PyQt5(界面)、pySerial(串口通信)、matplotlib(图表)。装起来很简单,在PyCharm的Terminal里敲:

pip install PyQt5
pip install pySerial
pip install matplotlib

等几分钟,看到「Successfully installed」就完事了。但如果你遇到报错,别慌,我总结了几种常见情况:

报错信息 原因 解决办法
pip不是内部或外部命令 Python没加到PATH 重装Python,勾选Add to PATH
ERROR: Could not find a version that satisfies the requirement Python版本太高,库不兼容 换Python 3.8或3.9
Microsoft Visual C++ 14.0 is required 缺少C++编译工具 安装Visual Studio Build Tools,或者用预编译的wheel包

我曾经在装PyQt5时卡在「Microsoft Visual C++ 14.0 is required」这个错误上,折腾了一下午。后来发现直接去PyPI下载对应的.whl文件,用pip install xxx.whl安装就绕过去了。说白了,Windows下装Python库,有时候就是得灵活点。

装完后验证一下,在Python交互环境里输入:

import PyQt5
import serial
import matplotlib
print("所有库导入成功!")

没报错?恭喜,环境搭好了。接下来咱们就可以开始写代码了。

总结一下:Python 3.9 + PyCharm + 虚拟环境,这是我最推荐的组合。别图新鲜用最新版,稳定才是王道。下一章咱们开始写第一个PyQt5窗口,到时候你就知道环境搭好有多爽了。