操作系统与基础工具准备：Windows/Linux双系统选择，安装Git、VS Code、Python3.8+、CMake等基础工具
说实话，搭建QGC地面站环境这件事，我见过太多人卡在第一步了。不是工具装不上，而是操作系统选错了。今天咱们就把这事聊透。
Windows还是Linux？我的建议
先给结论：Windows做日常开发，Linux做编译和测试。这不是二选一的问题，而是两个都要。
我个人习惯在Windows上写代码、看文档、调试界面，因为VS Code在Windows下的体验确实好。但QGC的编译链、PX4固件编译、MAVSDK这些，在Linux下更顺畅。你想想看，如果非要在Windows下折腾交叉编译，光是环境变量就能把你搞疯。
我的推荐方案：
- 主力机：Windows 10/11（日常办公、代码编辑、文档查阅）
- 虚拟机/双系统：Ubuntu 20.04 LTS（编译QGC、运行仿真、测试MAVSDK）
- 备选：WSL2（Windows Subsystem for Linux 2）——轻量级方案，适合不想重启的人
我曾经在项目里踩过一个坑：团队里有人用Windows硬扛QGC编译，结果每次编译都要等40分钟，还经常报链接错误。后来换成Ubuntu，15分钟搞定。说白了，工具选对了，后面的事就顺了。
双系统 vs 虚拟机 vs WSL2
这三种方式我都用过，给你列个对比表，自己看哪个适合你。
| 方案 | 性能 | 便利性 | 适用场景 | 我的评价 |
|---|---|---|---|---|
| 双系统 | 原生性能，100% | 需重启切换 | 长期开发、编译频繁 | 最稳，但切换麻烦 |
| 虚拟机 | 约80%原生性能 | 随时切换，无需重启 | 轻量测试、学习 | 适合新手入门 |
| WSL2 | 接近原生 | 与Windows无缝集成 | 日常开发、小规模编译 | 我目前的主力方案 |
我的建议：如果你是新手，先装虚拟机。等确定这条路走通了，再考虑双系统或WSL2。别一上来就搞双系统，分区搞坏了数据全没了——我当年就干过这事。
基础工具安装清单
好，操作系统定下来了。接下来装工具。我把它们分成三组，按顺序来。
第一组：版本管理工具——Git
Git是必须的。QGC的源码在GitHub上，你要拉代码、切分支、提交修改，全得靠它。
安装步骤：
- 去
git-scm.com下载对应系统的安装包 - Windows下一路默认安装，注意勾选"Git Bash Here"
- Linux下直接
sudo apt install git - 安装完验证：
git --version
我记得第一次用Git的时候，被分支合并搞到崩溃。后来养成习惯：每次拉代码前先 git pull --rebase，能少很多冲突。
第二组：代码编辑器——VS Code
VS Code是目前最适合QGC开发的编辑器，没有之一。插件生态好，调试方便，还能直接连WSL。
安装要点：
- 去
code.visualstudio.com下载 - 安装后必装插件：C/C++、Python、CMake Tools、GitLens
- 如果用了WSL2，装Remote - WSL插件，直接在Windows里编辑Linux文件
注意：VS Code的自动更新有时候会搞崩插件。我建议关掉自动更新，等确认新版本稳定了再手动升。
第三组：编译工具链——Python3.8+ 和 CMake
QGC的构建系统依赖CMake，而Python用于脚本和测试工具。
Python安装：
- Windows：去python.org下载3.8以上版本，安装时勾选"Add Python to PATH"
- Linux：
sudo apt install python3 python3-pip - 验证：
python --version（Windows）或python3 --version（Linux）
CMake安装：
- Windows：下载安装包，注意选"Add CMake to system PATH"
- Linux：
sudo apt install cmake - 验证：
cmake --version
一个小技巧：Python版本别追新。QGC目前对Python 3.10以上支持不太好，我建议就用3.8或3.9，稳得很。
工具安装后的验证清单
装完别急着走，花5分钟验证一下。我列了个检查表，照着来一遍。
| 工具 | 验证命令 | 预期输出 |
|---|---|---|
| Git | git --version |
git version 2.25.1 或更高 |
| VS Code | code --version |
显示版本号和commit ID |
| Python | python3 --version |
Python 3.8.x 或 3.9.x |
| CMake | cmake --version |
cmake version 3.16.x 或更高 |
如果哪个命令报"未找到"，别慌。多半是环境变量没配好。Windows下去系统环境变量里加一下路径，Linux下检查一下 ~/.bashrc 里的PATH。
本章知识体系总览
下面这张图把本章的核心逻辑串起来了。你可以把它当作一张"导航图"，后面每装一个工具，回来看看它在整个体系里的位置。
嗯，这张图把今天的内容全串起来了。从上到下：先选操作系统方案，再装四个基础工具，最后用验证清单收尾。每一步都踩实了，后面编译QGC才不会出幺蛾子。
避坑指南
最后分享几个我踩过的坑，你遇到了直接跳过。
- Python版本冲突：我曾经在Windows上装了Python 3.11，结果QGC的某个依赖包死活装不上。后来换成3.9，一次过。所以别追新，3.8或3.9最稳。
- CMake找不到编译器：Windows下装完CMake，编译时报"找不到C编译器"。原因是没装Visual Studio Build Tools。去装个VS 2019/2022，选上"使用C++的桌面开发"工作负载就行。
- Git换行符问题：Windows和Linux混用时，Git会把换行符自动转换。QGC的代码里有些文件对换行符敏感。建议在Windows下执行
git config --global core.autocrlf input，统一用LF。 - WSL2网络代理：如果你用WSL2，记得在
~/.bashrc里配好代理，不然git clone慢到怀疑人生。