1. 环境准备Ubuntu 22.04基础配置在开始PX4仿真环境搭建之前确保你的Ubuntu 22.04系统已经完成基础配置。我遇到过不少因为系统环境不干净导致的奇怪问题所以建议先执行以下操作首先更新软件源并升级现有包这个步骤能避免很多依赖冲突sudo apt update sudo apt upgrade -y接着安装开发必备工具链这些是后续编译PX4和ROS2的基础sudo apt install build-essential cmake git python3-pip -y特别提醒Ubuntu 22.04用户要注意Python版本问题。系统默认的Python3.10可能会与某些ROS2工具产生冲突建议用以下命令检查python3 --version如果遇到Python环境问题可以考虑使用virtualenv创建隔离环境。我习惯在用户目录下建立专用工作空间mkdir -p ~/px4_ws cd ~/px4_ws python3 -m venv px4env source px4env/bin/activate注意有些教程会建议修改系统默认Python版本这可能导致系统组件异常。实测使用虚拟环境更安全可靠。2. ROS2 Humble安装避坑指南2.1 选择正确的安装方式官方提供了多种ROS2安装方式但针对PX4开发场景我强烈推荐使用国内开发者维护的一键安装工具。原版官方安装经常会因为网络问题导致依赖下载失败wget http://fishros.com/install -O fishros . fishros这个脚本会自动配置国内镜像源安装速度提升明显。安装完成后记得验证核心组件source /opt/ros/humble/setup.bash ros2 run demo_nodes_cpp talker在另一个终端运行监听节点ros2 run demo_nodes_py listener如果能看到Hello World消息交互说明ROS2核心安装成功。但这里有个隐藏坑点默认安装的Gazebo版本可能与PX4不兼容。我建议先不要急着安装Gazebo等PX4环境配置完成后再处理。2.2 解决Gazebo版本冲突这是最常见的坑点之一。ROS2 Humble默认会安装Harmonic版本的Gazebo而PX4 v1.14.0需要Garden版本。如果直接使用默认安装会导致地面站报ekf2 missing data错误。正确的做法是先卸载冲突版本sudo apt remove gz-harmonic ros-humble-ros-gz* -y然后安装指定版本sudo apt install gz-garden ros-humble-ros-gzgarden -y验证Gazebo版本是否匹配gz sim --versions应该看到输出包含garden v7.x.x。如果版本仍不正确可能需要手动添加Gazebo仓库sudo wget https://packages.osrfoundation.org/gazebo.gpg -O /usr/share/keyrings/pkgs-osrf-archive-keyring.gpg echo deb [arch$(dpkg --print-architecture) signed-by/usr/share/keyrings/pkgs-osrf-archive-keyring.gpg] http://packages.osrfoundation.org/gazebo/ubuntu-stable $(lsb_release -cs) main | sudo tee /etc/apt/sources.list.d/gazebo-stable.list /dev/null sudo apt update3. PX4固件编译与配置3.1 获取正确版本的PX4源码PX4的版本匹配非常关键不同版本对Gazebo和ROS2的要求不同。对于Ubuntu 22.04 ROS2 Humble组合建议使用v1.14.0稳定版git clone https://github.com/PX4/PX4-Autopilot.git --recursive cd PX4-Autopilot git checkout v1.14.0 git submodule update --init --recursive实测发现如果clone时没有加--recursive参数后续子模块更新可能会失败导致编译时缺少关键组件。3.2 安装编译依赖PX4的依赖安装有个小技巧使用官方脚本但跳过不需要的工具链可以节省大量时间和磁盘空间cd PX4-Autopilot/Tools/setup ./ubuntu.sh --no-nuttx --no-sim-tools这个命令会安装编译所需的核心依赖但跳过了嵌入式开发工具链和仿真工具因为我们后面会单独处理Gazebo。3.3 编译SITL仿真环境编译命令的选择直接影响后续仿真能否正常运行。推荐使用gz_x500目标make px4_sitl gz_x500第一次编译可能需要30分钟以上取决于机器性能。如果编译失败最常见的原因是内存不足至少需要8GB或网络问题导致依赖下载不完整。编译成功后可以测试Gazebo仿真gz sim -v4 -r x500.sdf应该能看到X500无人机模型出现在Gazebo场景中。如果Gazebo启动但无人机不显示很可能是模型路径设置问题检查GAZEBO_MODEL_PATH环境变量echo $GAZEBO_MODEL_PATH应该包含PX4-Autopilot/Tools/simulation/gz/models路径。4. QGroundControl地面站配置4.1 解决权限问题地面站软件QGroundControlQGC在Linux下运行时需要特别注意权限配置否则会出现无法连接设备的问题sudo usermod -a -G dialout $USER sudo apt-get remove modemmanager -y这些命令将当前用户加入dialout组并移除可能冲突的ModemManager服务。修改后需要注销重新登录才能生效。4.2 安装依赖库QGC需要一些额外的多媒体库支持sudo apt install gstreamer1.0-plugins-bad gstreamer1.0-libav \ gstreamer1.0-gl libfuse2 libxcb-xinerama0 \ libxkbcommon-x11-0 libxcb-cursor0 -y4.3 启动与配置技巧下载AppImage格式的QGC后建议专门创建启动脚本#!/bin/bash cd ~/Downloads/ chmod x QGroundControl.AppImage ./QGroundControl.AppImage保存为start_qgc.sh并赋予执行权限。这样每次启动时可以确保工作目录正确避免日志文件散落各处。5. Micro XRCE-DDS Agent配置5.1 源码编译安装PX4与ROS2的通信依赖这个中间件必须从源码编译安装git clone https://github.com/eProsima/Micro-XRCE-DDS-Agent.git cd Micro-XRCE-DDS-Agent mkdir build cd build cmake .. make sudo make install sudo ldconfig /usr/local/lib5.2 启动参数优化运行Agent时推荐使用以下参数组合稳定性和性能更好MicroXRCEAgent udp4 -p 8888 -v6-v6参数启用详细日志调试时非常有用。正式运行时可以去掉以提升性能。6. Offboard控制实例实战6.1 创建工作空间建议为PX4 ROS2开发创建独立的工作空间mkdir -p ~/px4_ros2_ws/src cd ~/px4_ros2_ws/src6.2 获取消息定义PX4的ROS2接口依赖特定的消息定义必须匹配固件版本git clone https://github.com/PX4/px4_msgs.git -b release/1.14 git clone https://github.com/PX4/px4_ros_com.git -b release/v1.146.3 编译与运行使用colcon工具编译工作空间cd ~/px4_ros2_ws colcon build运行offboard示例的标准流程启动QGroundControl新终端启动MicroXRCEAgent另一个终端启动Gazebo仿真最后运行offboard控制节点source install/setup.bash ros2 run px4_ros_com offboard_control7. 常见问题解决方案7.1 EKF2数据丢失错误这是最典型的版本不匹配症状表现为地面站显示Preflight Fail: ekf2 missing data。解决方法已在前文Gazebo版本部分说明核心是确保Gazebo版本为GardenROS2 bridge对应版本正确PX4固件版本匹配7.2 模型加载失败如果Gazebo启动后看不到无人机模型检查echo $GAZEBO_RESOURCE_PATH echo $GAZEBO_MODEL_PATH应该包含PX4-Autopilot/Tools/simulation/gz下的相应路径。可以手动设置export GAZEBO_RESOURCE_PATH$GAZEBO_RESOURCE_PATH:~/PX4-Autopilot/Tools/simulation/gz export GAZEBO_MODEL_PATH$GAZEBO_MODEL_PATH:~/PX4-Autopilot/Tools/simulation/gz/models7.3 ROS2话题无法通信如果offboard控制无法生效按以下步骤排查检查MicroXRCEAgent是否正常运行确认PX4参数MAV_2_CONFIG设置为DDS验证ROS2话题列表ros2 topic list应该能看到/px4_ros_com/*相关话题。如果没有可能是PX4与Agent的连接问题。