3. 开发环境搭建

PX4目标跟随项目的开发链路横跨嵌入式飞控、机器人中间件与地面站可视化三个技术栈，环境搭建的质量直接决定后续目标检测、坐标转换与飞行控制调试的效率。本章围绕Ubuntu 22.04/20.04、ROS2 Humble/Foxy、PX4 Autopilot、Gazebo/jMAVSim仿真器以及QGroundControl地面站五大部分，给出从零到仿真无人机正常起飞的完整操作路径，并针对版本兼容性、环境变量、编译缓存等高频故障点提供排障方法。

上图展示了目标跟随项目开发环境的核心分层：主机操作系统提供底层驱动与编译工具链，ROS2作为机器人通信与算法编排中间件，PX4仿真环境负责飞控逻辑与传感器模拟，QGroundControl则承担地面监控与指令下发。各层之间通过DDS、MAVLink和UDP协议进行数据交互，形成完整的闭环开发链路。

3.1 核心原理：版本兼容性与环境分层

PX4目标跟随项目涉及多个软件栈的协同工作，版本兼容性是环境搭建的首要约束。PX4官方对ROS2的支持策略是：Foxy对应Ubuntu 20.04，Humble对应Ubuntu 22.04，而Gazebo仿真器又分为Classic（经典版）和Ignition（新架构）两个系列。选择版本组合时，需要遵循以下原则：

• ROS2版本与Ubuntu版本强绑定：Humble仅支持Ubuntu 22.04，Foxy仅支持Ubuntu 20.04，混用会导致依赖冲突。
• PX4固件版本与仿真器匹配：PX4 v1.13及以上版本默认支持Gazebo Classic，v1.14开始逐步迁移至Gazebo Ignition（现在称为Gazebo Garden）。
• MAVROS与ROS2的桥接：若使用MAVROS作为PX4与ROS2的通信桥梁，需要确认MAVROS版本支持对应的ROS2发行版。
• Python依赖隔离：目标检测通常依赖OpenCV、PyTorch或TensorFlow，建议使用conda或venv创建独立环境，避免与系统Python冲突。

环境分层的核心思想是：将系统级依赖、项目级依赖和运行时依赖分离。系统级依赖通过apt安装，项目级依赖通过ROS2的colcon工作空间管理，运行时依赖（如模型权重、配置文件）则放在独立目录中。这种分层方式可以显著降低环境迁移和团队协作时的配置成本。

3.2 操作流程：从零搭建完整仿真环境

以下操作流程以Ubuntu 22.04 + ROS2 Humble + PX4 v1.14 + Gazebo Classic为基准组合，同时标注Foxy版本的差异点。整个流程预计耗时60-90分钟，取决于网络速度和编译性能。

步骤1：基础系统配置

# 更新系统软件源
sudo apt update && sudo apt upgrade -y

# 安装基础工具链
sudo apt install -y git cmake ninja-build python3-pip python3-venv \
  python3-dev build-essential pkg-config

# 安装地理信息依赖（PX4编译必需）
sudo apt install -y libgeographic-dev libeigen3-dev libgstreamer1.0-dev \
  libgstreamer-plugins-base1.0-dev

注意：Ubuntu 20.04用户需要将python3-venv替换为python3.8-venv，并确认CMake版本不低于3.16。

步骤2：安装ROS2 Humble

# 设置编码
sudo apt install -y locales
sudo locale-gen en_US en_US.UTF-8
sudo update-locale LC_ALL=en_US.UTF-8 LANG=en_US.UTF-8

# 添加ROS2软件源
sudo apt install -y software-properties-common curl
sudo add-apt-repository universe
sudo curl -sSL https://raw.githubusercontent.com/ros/rosdistro/master/ros.key \
  -o /usr/share/keyrings/ros-archive-keyring.gpg
echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/ros-archive-keyring.gpg] \
  http://packages.ros.org/ros2/ubuntu $(. /etc/os-release && echo $UBUNTU_CODENAME) main" | \
  sudo tee /etc/apt/sources.list.d/ros2.list > /dev/null

# 安装ROS2桌面版（包含可视化工具）
sudo apt update
sudo apt install -y ros-humble-desktop ros-humble-ros-base
sudo apt install -y ros-dev-tools

# 配置环境变量
echo "source /opt/ros/humble/setup.bash" >> ~/.bashrc
source ~/.bashrc

Foxy用户将humble替换为foxy即可，但需注意Foxy的EOL（生命周期结束）时间为2023年5月，建议新项目直接使用Humble。

步骤3：编译PX4 Autopilot固件

# 克隆PX4固件仓库（使用v1.14稳定分支）
git clone --recursive https://github.com/PX4/PX4-Autopilot.git -b v1.14.0
cd PX4-Autopilot

# 安装PX4依赖（自动检测Ubuntu版本）
bash ./Tools/setup/ubuntu.sh

# 编译仿真目标（Gazebo Classic）
make px4_sitl gazebo-classic

编译过程需要20-40分钟，期间会下载Gazebo模型和依赖库。如果网络不稳定，建议使用代理或镜像源。编译成功后，终端会显示[INFO] PX4 SITL started，并自动启动Gazebo窗口。

步骤4：安装QGroundControl地面站

# 下载QGC AppImage（约200MB）
wget https://d176tv9ibo4jno.cloudfront.net/latest/QGroundControl.AppImage
chmod +x QGroundControl.AppImage

# 安装fuse依赖（AppImage运行必需）
sudo apt install -y libfuse2

# 启动QGC
./QGroundControl.AppImage

QGC启动后会自动通过UDP 14550端口发现PX4仿真实例。首次启动会提示校准传感器，在仿真模式下直接跳过即可。

步骤5：验证仿真无人机起飞

# 在PX4终端中执行起飞指令（需先解锁）
commander takeoff

更推荐的方式是通过QGC界面操作：点击右上角的起飞按钮，设置起飞高度（建议3-5米），观察无人机是否平稳升空并悬停。验证标准包括：

• QGC状态栏显示“Ready to Fly”（绿色）
• 无人机模型在Gazebo中垂直上升至设定高度
• HUD显示高度、速度、姿态角数据实时更新
• 遥控器（若使用）或QGC虚拟摇杆可控制无人机移动

3.3 案例拆解：Gazebo启动崩溃与版本冲突排障

在实际搭建过程中，最常见的故障是Gazebo启动后立即崩溃或黑屏。以下是一个典型的排障案例：

另一个高频问题是ROS2与Gazebo的DDS通信超时。当运行ros2 topic list无法看到/vehicle/odom等话题时，通常是因为FastDDS的发现协议在虚拟机或容器中受限。解决方法是在启动PX4前设置：

export ROS_DOMAIN_ID=42
export RMW_IMPLEMENTATION=rmw_fastrtps_cpp
export FASTRTPS_DEFAULT_PROFILES_FILE=/path/to/fastdds_profile.xml

其中fastdds_profile.xml需要配置共享内存传输或UDPv4传输，具体模板可在PX4官方文档中获取。

3.4 常见误区与总结复盘

环境搭建阶段的错误往往会在后续开发中放大，以下是需要特别注意的误区：

误区	后果	正确做法
使用Ubuntu 24.04安装ROS2 Humble	依赖冲突，rosdep无法解析	严格遵循ROS2发行版与Ubuntu版本对应表
在conda环境中编译PX4	Python路径混乱，编译失败	PX4编译使用系统Python，conda环境仅用于目标检测算法
忽略Gazebo模型下载失败	仿真世界空白，无人机不可见	检查~/.gazebo/models目录完整性
QGC与PX4端口冲突	地面站无法连接	确认UDP 14550端口未被占用，关闭其他MAVLink工具
直接使用sudo make编译	文件权限污染，后续增量编译失败	始终使用普通用户编译，必要时sudo chown修复权限

总结复盘时，建议建立环境验证清单，每次修改环境后按顺序检查：

1. ros2 doctor确认ROS2环境健康
2. px4 status确认PX4固件版本
3. gazebo --version确认仿真器版本
4. QGC连接状态显示“Connected”
5. 执行commander takeoff验证飞行控制链路