第3章：源码获取与版本管理——从GitHub克隆QGC
好，咱们进入实战环节。源码都拿不到，后面全是空谈。这一章我带你走一遍从GitHub上把QGC源码拉下来的完整流程，顺便聊聊分支怎么选、版本怎么管。
说实话，我见过太多新手一上来就git clone主干，结果编译到一半发现依赖对不上，卡在那干瞪眼。嗯，咱们别走那个弯路。
3.1 准备工作：先把环境搭好
在敲命令之前，有几样东西你得先装上。我列个清单，你对照着检查一下：
| 工具 | 最低版本 | 用途 |
|---|---|---|
| Git | 2.20+ | 版本控制，拉取/切换代码 |
| CMake | 3.16+ | 构建系统配置 |
| Qt | 5.15.2 或 6.x | QGC的UI框架依赖 |
| 编译器 | GCC 9+ / MSVC 2019+ | C++17编译支持 |
我的习惯：Git和CMake装完记得重启终端，不然环境变量没生效，你敲命令会报"找不到命令"。别问我怎么知道的……踩过。
3.2 克隆仓库：选对URL和分支
QGC的官方仓库在 https://github.com/mavlink/qgroundcontrol。但你别急着直接clone主干，先想清楚你要干什么。
我个人习惯把分支分成三类：
- 稳定版分支：比如
Stable_v4.2、Stable_v4.3。适合产品开发，bug少，文档全。 - 开发主干：
master或main。最新特性都在这里，但可能不稳定。我一般只在尝鲜或贡献代码时用。 - 特性分支：比如
feature/new-joystick。社区贡献的试验功能，别用在生产环境。
怎么选？我给你一个决策流程：
- 如果你是做产品，直接选最新的 Stable_v4.x 分支。
- 如果你想学习最新代码结构，选 master。
- 如果你要修某个特定bug，去GitHub Issues里找对应的 fix/xxx 分支。
核心原则：永远不要直接在master上改代码。拉一个自己的开发分支出来，哪怕只是改一行配置。
3.3 实操：克隆命令与参数
好，咱们动手。打开终端，进到你准备放代码的目录，然后执行：
# 克隆稳定版（推荐）
git clone -b Stable_v4.3 --depth 1 https://github.com/mavlink/qgroundcontrol.git
# 克隆最新开发版
git clone https://github.com/mavlink/qgroundcontrol.git这里有个小细节：--depth 1 是浅克隆，只拉取最新一次提交。仓库有几百兆历史，你如果只是编译用，浅克隆能省一半时间。我刚开始做QGC二次开发时没加这个参数，等了快20分钟……后来学乖了。
如果你已经克隆了完整仓库，想切到稳定版：
cd qgroundcontrol
git fetch --all
git checkout Stable_v4.33.4 版本管理策略：别让代码变成一团乱麻
代码拉下来了，怎么管？我见过最惨的情况是：一个团队五个人，每个人都在master上直接改，合并时冲突几百个文件。嗯，那场面……
我建议你用这套策略：
| 层级 | 分支名示例 | 谁在维护 | 用途 |
|---|---|---|---|
| 上游 | upstream/Stable_v4.3 |
QGC官方 | 跟踪官方更新 |
| 主开发 | develop |
你或团队 | 日常开发集成分支 |
| 特性分支 | feature/custom-joystick |
个人 | 每个功能独立开发 |
| 修复分支 | hotfix/altitude-bug |
个人 | 紧急bug修复 |
具体操作流程是这样的：
- 从
upstream/Stable_v4.3拉取最新代码到本地develop。 - 从
develop切出特性分支，比如feature/custom-joystick。 - 在特性分支上开发、测试。
- 测试通过后，合并回
develop。 - 定期把
develop合并到master做发布。
我曾经踩过的坑：有一次我直接在develop上改了一天，然后发现官方Stable分支更新了一个关键补丁。我想合并，结果冲突多到崩溃。从那以后，我坚持特性分支开发，develop只做合并和集成。
3.5 知识结构图：版本管理全景
下面这张图把整个流程串起来了。你看一眼，心里就有数了。
3.6 日常操作：拉取、合并、回退
代码管起来了，日常操作也得顺手。我列几个最常用的命令，你直接复制用：
# 拉取上游最新代码
git fetch upstream
git checkout develop
git merge upstream/Stable_v4.3
# 创建新特性分支
git checkout -b feature/my-feature develop
# 提交代码
git add .
git commit -m "feat: 添加自定义摇杆支持"
# 合并回develop
git checkout develop
git merge --no-ff feature/my-feature
# 如果搞砸了，回退到上一个版本
git reset --hard HEAD~1一个小技巧：提交信息我习惯用 feat:、fix:、docs: 这样的前缀。你翻看git log时一目了然，比写"改了点东西"强一百倍。
3.7 避坑指南：我替你试过的错
最后，分享几个我亲身踩过的坑，你遇到了别慌：
- 克隆超时：国内网络连GitHub不稳定。加个代理或者用Gitee镜像，别死磕。
- 子模块没拉全：QGC依赖一些子模块，比如
libs/mavlink。记得执行git submodule update --init --recursive。 - 分支名记混了：我建议本地分支名和上游保持一致，比如
Stable_v4.3，别自己起个my-branch然后忘了对应哪个版本。 - 合并冲突不会解：用
git mergetool打开可视化工具，比手动改靠谱。我习惯用Meld，免费又好用。
嗯，源码获取和版本管理就这些。你按这个流程走，后面编译的时候会省很多事。代码不乱，心情就好，对吧？