开发环境总览：搭建环境所需的工具链、操作系统选择与整体流程
说实话，很多初学者一上来就急着敲代码，结果卡在环境搭建上两三天。我当年第一次搞 ArduPilot 编译，光装依赖就折腾了一整个周末。后来带团队时发现，80% 的编译报错其实都是环境没配好。
所以这一章，我们先不急着动手。把整个开发环境拆开看看，搞清楚需要什么、为什么选它、整体怎么走。心里有谱了，后面才顺。
一、操作系统选择：为什么我推荐 Ubuntu
ArduPilot 官方支持 Linux、Windows 和 macOS。但说实话，Windows 上的坑最多。我见过有人在 Windows 下编译，光是路径大小写问题就改了一下午。
我的建议：直接用 Ubuntu 20.04 LTS 或 22.04 LTS。
为什么？
- 原生支持：ArduPilot 的构建脚本、工具链都是为 Linux 设计的。Ubuntu 是 Debian 系，包管理最省心。
- 社区一致：你去 ArduPilot 的讨论组看看，90% 的教程、报错解答都是基于 Ubuntu 的。你用 Windows 出问题了，别人可能都没法复现。
- 交叉编译方便：飞控代码最终要烧到 ARM 芯片上。Ubuntu 下的交叉编译器、工具链安装就是一条命令的事。
二、工具链全景图：你到底需要装什么？
很多人一看到「工具链」三个字就头大。其实说白了，就是几类东西：
| 类别 | 具体工具 | 干什么用的 |
|---|---|---|
| 编译器 | gcc-arm-none-eabi | 把 C++ 代码编译成飞控芯片能跑的机器码 |
| 构建系统 | Python 3 + waf | 管理编译流程，自动处理依赖和配置 |
| 版本控制 | Git | 拉取代码、管理自己的修改 |
| 调试工具 | OpenOCD + GDB | 烧录固件、在线调试、看寄存器 |
| 仿真环境 | Gazebo / SITL | 没真机也能跑飞控逻辑，验证代码 |
嗯，这里要注意：不要一股脑全装。我见过有人照着教程把工具链装了两遍，结果冲突了。按需安装，后面用到什么装什么。
三、整体搭建流程概览
整个流程其实就五步。我画了张图，你一看就明白：
你看，其实不复杂。就是一条直线，每一步都有明确的输入和输出。
四、各步骤的核心要点
1. 安装 Ubuntu
如果你用虚拟机，记得给至少 4GB 内存、40GB 硬盘。我刚开始用 2GB 内存，编译到一半直接卡死。物理机双系统也行，但虚拟机的好处是快照——配坏了直接回滚，不用重装。
2. 安装基础工具
Git 和 Python3 是必须的。ArduPilot 的构建脚本是 Python 写的，没有 Python 寸步难行。
sudo apt update
sudo apt install git python3 python3-pip -y3. 拉取源码
用 Git 克隆 ArduPilot 的主仓库。建议用 --recursive 参数，把子模块一起拉下来。
git clone --recursive https://github.com/ArduPilot/ardupilot.git
cd ardupilot这里有个坑：网络不好的时候，子模块容易拉不全。我遇到过好几次，编译到一半报缺头文件，结果发现是子模块没拉完。解决办法是手动更新：
git submodule update --init --recursive4. 安装工具链
ArduPilot 官方提供了一个安装脚本，一键搞定：
cd ardupilot
Tools/environment_install/install-prereqs-ubuntu.sh -y这个脚本会装 gcc-arm-none-eabi、waf 以及各种依赖库。你想想看，要是手动一个个装，得折腾多久？
核心知识点：gcc-arm-none-eabi 是交叉编译器。你的电脑是 x86 架构，飞控芯片是 ARM 架构。交叉编译就是在 x86 上生成 ARM 能跑的代码。没有它，你写的代码飞控根本看不懂。
5. 编译验证
装完工具链后，先跑一次编译，验证环境是否正常：
./waf configure --board Pixhawk1
./waf copter如果编译通过，终端最后会显示 Build commands: ... 没有 error。我第一次编译成功时，看到那个输出，心里踏实多了。
五、避坑指南
我这些年踩过的坑，列几个最常见的：
- 路径有中文或空格：ArduPilot 的构建脚本对路径很敏感。我曾经把项目放在「桌面/我的飞控」里，编译直接报错。后来全部改成英文路径，再没出过问题。
- Python 版本冲突：如果你系统里同时有 Python 2 和 Python 3，waf 可能会调用错。建议把
python3设为默认：sudo update-alternatives --config python3。 - 磁盘空间不足：编译一次会生成大量中间文件。我建议至少留 20GB 空闲空间。有一次我编译到 90% 报磁盘满，气得我直接换了块硬盘。
- 网络代理问题：如果你在公司内网，Git 拉取子模块可能失败。配置好 Git 的代理：
git config --global http.proxy http://proxy:port。
六、本章小结
这一章我们理清了整个开发环境的全貌。你不需要记住所有细节，但心里要有这张图：
- 操作系统选 Ubuntu 20.04/22.04
- 工具链包括编译器、构建系统、版本控制、调试工具
- 搭建流程分五步：装系统 → 装基础工具 → 拉源码 → 装工具链 → 编译验证
- 每一步都有验证方法，不要跳步
环境搭建就像盖房子的地基。地基没打好，后面砌墙、装修都会出问题。我见过太多人急着写代码，结果环境没配好，浪费的时间比写代码还多。