第三章 开发环境搭建：工欲善其事，必先利其器
说实话，地面站开发这件事，环境搭好了，后面能省一半的力气。我见过太多人一上来就写代码，结果被版本冲突、依赖混乱搞得焦头烂额。这一章，咱们就把 Python 环境、PyCharm、Git 和虚拟管理这些基础工具一次性搞定。
本章核心目标：搭建一个稳定、可复现、便于协作的开发环境。说白了，就是让你和你的队友，在任何一台电脑上都能跑起来同样的代码。
3.1 Python 环境配置：选对版本，少走弯路
Python 版本选不对，后面全是坑。我个人习惯用 Python 3.8 或 3.9，为什么？因为地面站常用的库，比如 PyQt5、pyserial、numpy，在这些版本上兼容性最好。Python 3.10 以上有些语法改动，部分老库还没跟上。
安装步骤：
- 去 Python 官网下载对应版本（Windows 选 executable installer，Linux 用包管理器）。
- 安装时记得勾选
Add Python to PATH，不然你后面敲python命令会找不到。 - 验证安装：打开终端，输入
python --version，看到版本号就对了。
注意：我曾经遇到过一台电脑装了多个 Python 版本，结果 pip 装包装到了旧版本里，新版本死活找不到。建议只保留一个系统级 Python，其他用虚拟环境管理。
3.2 PyCharm 安装与配置：专业 IDE 的调教
PyCharm 是我用过最顺手的 Python IDE，没有之一。地面站项目代码量大、文件多，PyCharm 的智能提示和重构功能能帮你省不少时间。
安装要点：
- 下载 Community 版（免费）就够用，Professional 版对地面站开发来说有点浪费。
- 安装时勾选
.py关联，这样双击 .py 文件默认用 PyCharm 打开。
配置建议：
| 配置项 | 推荐值 | 说明 |
|---|---|---|
| 字体 | JetBrains Mono 14pt | 等宽字体，看代码不费眼 |
| 缩进 | 4 空格 | PEP8 标准，别用 Tab |
| 自动导入 | 开启 | 写代码时自动补全 import |
| 代码检查 | PEP8 + Flake8 | 帮你保持代码整洁 |
小技巧：在 PyCharm 里按 Ctrl + Shift + A，搜索 "Create Desktop Entry"，可以创建桌面快捷方式。嗯，这个细节很多人不知道。
3.3 Git 版本控制：你的代码后悔药
地面站开发不是一个人能搞定的。Git 就是你的后悔药，也是团队协作的基石。我刚开始用 Git 时也嫌麻烦，直到有一次不小心删了整个项目文件夹……从那以后，我每写一个功能就 commit 一次。
基础配置：
# 设置用户名和邮箱（GitHub 上注册的那个）
git config --global user.name "你的名字"
git config --global user.email "你的邮箱"
# 推荐配置：让 Git 记住密码
git config --global credential.helper store
# 查看配置
git config --list地面站项目常用 Git 工作流：
git init初始化仓库git add .添加所有文件到暂存区git commit -m "feat: 初始化地面站项目"提交git branch feature/telemetry创建新分支开发遥测模块git merge feature/telemetry合并回主分支
避坑指南：千万不要在 master 分支上直接改代码。我曾经有一次直接在 master 上改，结果队友 push 了冲突代码，我花了两个小时才解决。正确的做法是：每个功能开一个分支，测试通过后再合并。
3.4 虚拟环境管理：隔离依赖，避免冲突
虚拟环境这东西，说白了就是给你的每个项目一个独立的 Python 空间。你想想看，项目 A 用 PyQt5 5.15，项目 B 用 PyQt5 6.0，如果没有虚拟环境，这两个版本会打架打到死。
推荐方案：使用 venv（Python 内置）
# 创建虚拟环境（在项目根目录下执行）
python -m venv venv
# 激活虚拟环境
# Windows:
venv\Scripts\activate
# Linux/Mac:
source venv/bin/activate
# 安装依赖
pip install pyserial pyqt5 numpy
# 导出依赖列表（方便队友复现）
pip freeze > requirements.txt
# 退出虚拟环境
deactivate在 PyCharm 中配置虚拟环境：
- 打开项目，进入
File → Settings → Project → Python Interpreter - 点击齿轮图标，选择
Add - 选择
Existing environment，找到刚才创建的venv\Scripts\python.exe - 确定后，PyCharm 会自动识别虚拟环境中的包
个人经验：我习惯在项目根目录下放一个 requirements.txt，每次更新依赖后都重新生成一次。这样队友 clone 项目后，直接 pip install -r requirements.txt 就能搞定所有依赖。省心。
3.5 知识体系总览
下面这张图，把本章的核心逻辑串起来了。你照着这个流程走，环境搭建不会出大问题。
嗯，到这里，你的开发环境就基本成型了。记住一个原则：环境配置要文档化。把每一步都记下来，下次换电脑或者带新人，直接照着文档来，省时省力。
最后说一句：环境搭建看起来琐碎，但它是你后面所有工作的基础。我见过太多人在这上面翻车，花一整天排查“为什么我的代码跑不起来”，结果发现是 Python 版本不对。所以，别急，一步一步来。