3. 开发环境搭建：Python环境配置、PyQt5安装、依赖库管理
说实话，很多做运动控制的工程师，一听到「配环境」就头大。我当年也是这样——觉得写代码嘛，能跑就行。直到有一次，我在调试一个六轴机械臂的轨迹规划，结果因为Python版本不对，PyQt5死活装不上，折腾了整整一个下午。嗯，从那以后，我养成了一个习惯：先把环境搭得干干净净，再动手写代码。
这一章，我就带你一步步把开发环境搭好。别急，跟着我来，十分钟搞定。
3.1 Python环境配置
先说说Python版本。我个人建议用Python 3.8到3.10之间的版本。为什么？因为PyQt5在这些版本上最稳定。我试过Python 3.11，有些老库的兼容性会出问题，没必要给自己找麻烦。
第一步：下载Python
去官网 python.org 下载安装包。记得勾选「Add Python to PATH」这个选项。很多新手栽在这里——装完了在命令行打python没反应，其实就是PATH没配好。
第二步：验证安装
打开命令行（Windows用cmd或PowerShell，Mac/Linux用终端），输入：
python --version如果显示 Python 3.9.x 之类的，说明装好了。
第三步：配置虚拟环境
这一点我特别想强调。你想想看，一个项目用PyQt5，另一个项目用PyQt6，如果全装到全局，迟早会打架。所以我强烈建议每个项目都建一个独立的虚拟环境。
# 创建虚拟环境
python -m venv motion_control_env
# 激活虚拟环境
# Windows:
motion_control_env\Scripts\activate
# Mac/Linux:
source motion_control_env/bin/activate激活后，命令行前面会出现 (motion_control_env) 的提示，说明你已经在虚拟环境里了。干净、隔离、好管理——这就是我想要的。
.venv 文件夹来放虚拟环境，然后用 .gitignore 把它排除掉。这样代码仓库里不会塞一堆环境文件，清爽得很。
3.2 PyQt5安装
环境配好了，接下来装PyQt5。说白了，PyQt5就是Python和Qt之间的「翻译官」。你写Python代码，它帮你调用Qt的界面组件。
安装命令
在虚拟环境激活的状态下，直接一行命令：
pip install PyQt5等等，别急着敲回车。我建议你加上国内镜像源，不然下载速度会让你怀疑人生：
pip install PyQt5 -i https://pypi.tuna.tsinghua.edu.cn/simple装完之后，验证一下：
python -c "from PyQt5.QtWidgets import QApplication; print('PyQt5 installed successfully')"如果没报错，恭喜你，PyQt5已经装好了。
DLL load failed。后来发现是系统缺少Visual C++运行库。解决办法很简单：去微软官网下载安装「Visual C++ Redistributable for Visual Studio 2015-2022」即可。
3.3 依赖库管理
一个运动控制调试工具，光有PyQt5是不够的。你还需要处理数据、做数学计算、甚至跟硬件通信。下面是我常用的依赖库清单：
| 库名 | 用途 | 安装命令 |
|---|---|---|
| numpy | 数值计算、矩阵运算 | pip install numpy |
| matplotlib | 数据可视化、曲线绘制 | pip install matplotlib |
| pyserial | 串口通信（连接驱动器） | pip install pyserial |
| pyqtgraph | 高性能实时曲线显示 | pip install pyqtgraph |
批量安装
我习惯把这些依赖写到一个 requirements.txt 文件里：
PyQt5==5.15.9
numpy==1.24.3
matplotlib==3.7.1
pyserial==3.5
pyqtgraph==0.13.3然后一行命令全部装好：
pip install -r requirements.txt这样做的好处是——换一台电脑，或者团队成员要复现你的环境，只需要这一个文件就够了。干净、可复现、不扯皮。
requirements.txt 里固定版本号，而不是用 PyQt5>=5.15 这种写法。版本锁定，是成熟工程师的基本素养。
3.4 知识体系总览
下面这张图，是我为你梳理的本章知识结构。你可以把它当作一张「地图」——环境搭建这件事，其实就这三步：
你看，其实就这三块。Python环境是地基，PyQt5是骨架，依赖库是血肉。地基稳了，骨架正了，血肉填进去，你的调试工具就能跑起来了。
好了，环境搭好了。下一章，我们就开始写第一个PyQt5窗口——一个能显示实时运动数据的调试面板。到时候，你会看到自己亲手搭建的环境，跑出第一行代码。那种感觉，嗯，挺爽的。
公众号:蓝海资料掘金营，微信deep3321