3. 开发环境搭建:Python、PyCharm 与必备库

好,咱们正式开始动手。开发环境搭建这步,说重要也重要,说不重要也……其实挺重要的。我见过不少新手在这上面栽跟头,装了半天的东西最后连串口都打不开。嗯,咱们一步一步来,稳一点。

先定个版本基线
我个人习惯用 Python 3.9~3.11 之间,别太新也别太旧。PyCharm 社区版足够用,别急着花钱。库的版本我会列出我测试过的组合。

3.1 Python 环境安装

上 python.org 下载对应系统版本。Windows 勾选「Add Python to PATH」——这个我踩过坑,一开始没勾,后面命令行打 python 就报错,还得手动加环境变量,烦得很。

装完后打开终端(cmd 或 PowerShell),验证一下:

python --version
pip --version

如果能正常显示版本号,说明第一步走通了。如果提示「python 不是内部命令」,大概率是 PATH 没配置好。重新运行安装包,选 Modify 修复一下就行。

避坑:Python 多个版本共存
我曾经在同一个电脑上装了 Python 3.8、3.10 和 3.12,结果 pip install 装到了一个版本,运行又用另一个版本,排查了一下午。建议只保留一个 Python 版本,或者用虚拟环境区分。

3.2 PyCharm 安装与配置

去 JetBrains 官网下载 Community 版。安装一路 Next,注意勾选「Add launchers dir to PATH」和「.py」关联。这样右键 .py 文件就能直接 Open with PyCharm,方便。

首次启动会弹配置向导。我建议别选「Light」主题(除非你真的很喜欢),选「Darcula」或者「IntelliJ Light」都行。字体我调成 16px,眼睛舒服点。

新建项目时,Location 选一个专门的文件夹,比如 D:\XY2-100_Work。Interpreter 选「New environment using Virtualenv」——这是虚拟环境,隔离项目依赖,后面装库不会影响系统 Python。

说白了,PyCharm 就是个编辑器加项目管理器。我们用它的终端集成、代码补全和调试功能。

3.3 必备库安装:pyserial、numpy、matplotlib

这三个库是 XY2-100 通信开发的左膀右臂。我直接给命令:

pip install pyserial==3.5
pip install numpy==1.24.3
pip install matplotlib==3.7.1

如果你用 PyCharm 的话,更简单——打开下方 Terminal 标签,或者通过 File → Settings → Project → Python Interpreter → 点击 + 号搜索库名安装。

库名用途我常用的版本
pyserial串口通信,读写 COM 口3.5
numpy数组运算、数据处理1.24.3
matplotlib数据可视化、实时绘图3.7.1

装完后简单验证一下:

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

如果没报错,恭喜你,环境搭好了。如果报错 ModuleNotFoundError,检查是不是在正确的虚拟环境里装的。我经常犯这种错误——在系统 Python 里装了一堆库,结果 PyCharm 用的虚拟环境里啥都没有。

小技巧:一键安装所有依赖
把三个包名写进 requirements.txt,然后 pip install -r requirements.txt,一次搞定。

3.4 整体环境结构

下面这张图把整个开发环境搭建的流程画出来了。你看,分成四个区域:基础层、工具层、库层、验证层。按照箭头顺序走,基本不会出错。

XY2-100 上位机开发环境搭建流程 基础环境 Python 3.9~3.11 pip 包管理器 开发工具 PyCharm Community Virtualenv 隔离 核心库 pyserial numpy matplotlib 验证环境 python -c "import ..." 运行串口demo 💡 建议按箭头顺序依次安装 出现报错先检查上一步是否正确 环境版本:Python 3.10 · PyCharm Community 2023.2 · pyserial 3.5 · numpy 1.24.3 · matplotlib 3.7.1

3.5 验证环境:写个简单脚本

光装完还不算完,咱们跑一个小程序,确认三者能协同工作。新建一个 test_env.py:

import serial
import numpy as np
import matplotlib.pyplot as plt

print("pyserial version:", serial.__version__)
print("numpy version:", np.__version__)
print("matplotlib version:", plt.matplotlib.__version__)

# 随便画个图检验 matplotlib
x = np.linspace(0, 10, 100)
y = np.sin(x)
plt.plot(x, y)
plt.title("Environment Test OK")
plt.show()

如果能弹出正弦曲线窗口,说明环境搭建成功。如果窗口不显示,检查是否安装了完整版 matplotlib(有时需要 pip install matplotlib[qt])。

注意:串口相关测试需要硬件
如果你没有 XY2-100 硬件,可以先用 USB 转串口模块(比如 CH340G)短接 TX 和 RX 做回环测试。这部分我们下一章细说。

好了,到这里环境就全部到位了。回想我自己第一次搭 XY2-100 环境,就是被「用错了虚拟环境」这个小问题卡了半小时。你按照上面的流程来,每一步验证一下,基本不会走弯路。环境搭好了,后面写起代码来就顺了。