第1章：开发环境搭建

大家好，我是老张。做上位机开发这么多年，我见过太多人一上来就急着写代码，结果环境没配好，后面各种踩坑。今天咱们就把基础打牢——Python环境配置、PyCharm安装、虚拟环境管理，还有Git初始化。这些搞定了，后面30章你才能走得顺。

1.1 Python环境配置

先说Python。我个人习惯用Python 3.9或3.10，别追最新版。为什么？因为很多工业库还没适配。我在项目里吃过这个亏——用Python 3.11跑一个老项目，结果某个串口库直接报错，折腾了两天。

避坑指南： 我曾经在Windows上直接装Python 3.12，结果PyQt5死活装不上。后来发现是C++编译工具链的问题。所以，建议用3.9或3.10，稳定。

安装步骤很简单：

  1. 去Python官网下载对应版本（Windows选Windows installer 64-bit）
  2. 安装时记得勾选「Add Python to PATH」
  3. 安装完成后，打开命令行输入 python --version 验证

嗯，这里要注意：如果你电脑上同时有Python 2和Python 3，建议用 py -3.9 来指定版本。我一般会在系统环境变量里把Python 3的路径放在前面。

1.2 PyCharm安装与设置

PyCharm，说白了就是Python的IDE之王。我用了十年，从社区版到专业版，说实话社区版就够用。但如果你要做工业上位机，建议用专业版——它支持远程开发、数据库工具，还有专业的调试器。

安装时注意几点：

  • 选择「Customize」安装，别用默认
  • 勾选「.py」关联，这样双击就能打开
  • 主题我选Darcula，护眼

安装完第一件事：设置解释器。打开Settings → Project → Python Interpreter，点齿轮选「Add」。我建议选「Existing environment」，然后指向你刚装的Python 3.9。别用系统默认的，容易搞混。

我的小技巧： 在PyCharm里按两次Shift，输入「Registry」，找到「ide.suppress.double.click.handler」勾上。这样双击文件不会意外打开，做项目时特别有用。

1.3 虚拟环境管理

虚拟环境这东西，说白了就是给每个项目一个独立的Python小世界。你想想看，项目A用PyQt5 5.15，项目B用PyQt6，如果没有虚拟环境，它们会打架。我在一个电池化成项目里就遇到过——升级了某个库，结果另一个项目直接崩了。

Python自带的 venv 就够用。创建方法：

# 打开终端，进入项目目录
python -m venv venv

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

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

# 安装依赖
pip install pyqt5 pyserial numpy

# 导出依赖清单
pip freeze > requirements.txt

我个人习惯在项目根目录建一个 venv 文件夹。然后在PyCharm里设置解释器时，直接选这个 venv\Scripts\python.exe。这样团队协作时，每个人拉下代码，执行 pip install -r requirements.txt 就能复现环境。

重要： 虚拟环境文件夹不要提交到Git仓库！在 .gitignore 里加上 venv/。我见过有人把整个虚拟环境提交上去，结果文件体积直接上G，拉代码能拉半小时。

1.4 版本控制（Git）初始化

Git，做工业项目必备。你想想看，一个电池化成设备上位机，代码量少说几万行，没有版本控制，改错了想回退？门都没有。我在一个项目里，同事不小心删了某个关键模块，还好有Git，一个 git checkout 就救回来了。

初始化步骤：

  1. 安装Git（官网下载，一路默认）
  2. 配置用户名和邮箱：
git config --global user.name "你的名字"
git config --global user.email "你的邮箱"

然后进入项目目录：

git init
git add .
git commit -m "初始化项目：电池化成设备上位机"

嗯，这里要注意：第一次提交前，先创建 .gitignore 文件。我一般会忽略这些：

# Python
__pycache__/
*.pyc
*.pyo
venv/
.idea/
*.log
*.db

# 项目特定
config.ini  # 配置文件，不同环境不同
*.csv       # 数据文件，太大
logs/       # 日志文件

我个人习惯用 git status 检查一下，确保没有把不该提交的文件加进去。然后才 git add 和 git commit。

我的工作流： 每次写代码前先 git pull，写完后 git add → git commit → git push。提交信息要写清楚，比如「修复串口通信超时问题」，别写「update」这种没营养的。

1.5 环境验证

环境搭好了，咱们验证一下。写个简单的脚本：

import sys
import PyQt5
import serial
import numpy as np

print(f"Python版本: {sys.version}")
print(f"PyQt5版本: {PyQt5.QtCore.PYQT_VERSION_STR}")
print(f"PySerial版本: {serial.__version__}")
print(f"NumPy版本: {np.__version__}")

print("环境搭建成功！")

在PyCharm里右键运行，如果看到版本号都正常输出，恭喜你，环境搭好了。如果报错，别慌——大概率是解释器没选对，或者虚拟环境没激活。检查一下PyCharm右下角的解释器路径。

常见问题： 如果PyQt5报错「No module named 'PyQt5'」，先确认虚拟环境是否激活。如果激活了还报错，试试 pip install --upgrade pip 再重装。我遇到过好几次，都是pip版本太旧导致的。

好了，第一章就到这里。环境搭好了，后面咱们就可以开始写真正的上位机代码了。下一章，咱们聊聊项目结构设计——怎么组织代码，才能让团队协作不打架。

公众号:蓝海资料掘金营，微信deep3321

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