3、上位机开发环境搭建：Python环境配置、PyCharm安装、虚拟环境管理、常用库安装

说实话，很多初学者一上来就急着写代码，结果环境没配好，折腾半天连个串口都打不开。我见过太多这样的案例了。环境搭建这事儿，看着简单，但坑不少。咱们一步步来，把基础打扎实。

3.1 Python环境配置

Python版本怎么选？我个人习惯用Python 3.8或3.9。为什么？因为PyQt5和pyserial在这些版本上最稳定。Python 3.10以上有些库的兼容性会出问题，我踩过这个坑。

下载地址：python.org，别去其他地方下。安装时记得勾选「Add Python to PATH」，这个选项很多人会漏掉。漏掉之后，你在命令行敲python就会提示找不到命令。

我的小技巧：安装完成后，打开命令行，输入python --version和pip --version。如果都能正常显示版本号，说明环境配好了。这一步花不了30秒，但能帮你排除80%的问题。

3.2 PyCharm安装与配置

编辑器我推荐PyCharm Community版，免费且够用。专业版虽然功能多，但咱们做上位机开发，社区版完全够用。

安装过程很简单，一路Next就行。但有几个关键配置你得注意：

  1. 解释器设置：打开PyCharm，进入File → Settings → Project → Python Interpreter。这里要指定你刚才安装的Python解释器路径。
  2. 字体与主题：我个人喜欢用Darcula主题，字体选Consolas或JetBrains Mono，字号14。看代码不费眼。
  3. 自动导入：开启自动导入功能，写代码时能省不少事。
注意：千万不要用PyCharm自带的Python解释器！那个版本可能跟你系统安装的不一致。一定要手动指定你安装的Python路径。

3.3 虚拟环境管理

虚拟环境这东西，说白了就是给你的每个项目一个独立的Python运行空间。为什么需要？你想想看，项目A需要PyQt5 5.15，项目B需要PyQt5 5.12，如果没有虚拟环境，这两个版本就会打架。

我常用的方式有两种：

方式一：使用venv（Python内置）

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

# 激活虚拟环境（Windows）
myenv\Scripts\activate

# 激活虚拟环境（Mac/Linux）
source myenv/bin/activate

# 退出虚拟环境
deactivate

方式二：使用PyCharm内置功能

在PyCharm中创建新项目时，直接勾选「New environment using Virtualenv」。PyCharm会自动帮你创建并激活虚拟环境。我个人更推荐这种方式，省心。

避坑指南：我曾经在一个项目里忘了激活虚拟环境，直接往系统Python里装了一堆库。结果另一个项目跑不起来了，排查了半天才发现是库版本冲突。从那以后，我每个项目都老老实实用虚拟环境。

3.4 常用库安装

环境配好了，接下来就是装库。咱们做电梯调试工具，核心就两个库：PyQt5和pyserial。

3.4.1 安装PyQt5

pip install PyQt5
pip install PyQt5-tools  # 这个包含了Qt Designer等工具

PyQt5是咱们做界面的主力。它把Qt的C++接口封装成了Python，用起来很方便。安装完成后，你可以写个简单代码测试一下：

import sys
from PyQt5.QtWidgets import QApplication, QLabel

app = QApplication(sys.argv)
label = QLabel("Hello, 电梯调试工具!")
label.show()
sys.exit(app.exec_())

如果能看到一个窗口弹出来，说明PyQt5安装成功了。

3.4.2 安装pyserial

pip install pyserial

pyserial是咱们跟下位机通信的桥梁。电梯的控制器、变频器，基本都是通过串口跟电脑通信的。安装完成后，测试一下：

import serial

# 列出所有可用的串口
import serial.tools.list_ports
ports = serial.tools.list_ports.comports()
for port in ports:
    print(f"找到串口: {port.device}")

如果你电脑上插了USB转串口设备，这里就能看到对应的COM口。

3.4.3 其他常用库

库名 用途 安装命令
numpy 数据处理，比如解析电梯的运行数据 pip install numpy
matplotlib 绘制曲线，比如电梯运行速度曲线 pip install matplotlib
openpyxl 导出调试报告到Excel pip install openpyxl
重点：所有库的安装，一定要在虚拟环境激活的状态下进行！否则库会装到系统Python里，你的项目根本用不到。

3.5 环境验证

装完库之后，我习惯写一个完整的测试脚本，确保所有东西都能正常工作：

import sys
import serial
from PyQt5.QtWidgets import QApplication, QMainWindow, QLabel

class MainWindow(QMainWindow):
    def __init__(self):
        super().__init__()
        self.setWindowTitle("环境测试")
        self.setGeometry(100, 100, 400, 300)
        
        label = QLabel("环境搭建成功！", self)
        label.move(150, 130)

if __name__ == "__main__":
    # 测试PyQt5
    app = QApplication(sys.argv)
    window = MainWindow()
    window.show()
    
    # 测试pyserial
    try:
        ser = serial.Serial()
        print("pyserial 导入成功")
    except Exception as e:
        print(f"pyserial 测试失败: {e}")
    
    sys.exit(app.exec_())

运行这个脚本，如果窗口能正常显示，控制台输出「pyserial 导入成功」，那你的环境就彻底配好了。

我的建议：把这个测试脚本保存下来，以后换电脑或者重装系统时，直接跑一遍就能确认环境是否正常。省时省力。

嗯，环境搭建这块就这些内容。看起来步骤多，但熟练之后，10分钟就能搞定。下一章咱们就开始写真正的电梯调试工具了，到时候这些库都会派上用场。

← 上一章 📖 返回目录 下一章 →