Ubuntu20.04部署XTDrone避坑实践指南

1. 环境准备：Ubuntu20.04基础配置

在开始部署XTDrone之前，确保你的Ubuntu20.04系统处于最佳状态。我建议先执行以下命令更新系统基础软件包：

sudo apt update && sudo apt upgrade -y

这个步骤看似简单，但很多新手会忽略。去年我在给团队搭建测试环境时，就遇到过因为基础库版本过低导致的ROS安装失败。更新后建议重启系统，确保所有更新生效。

对于双系统用户，需要特别注意磁盘空间分配。XTDrone及其依赖组件安装后至少需要30GB空间，建议预留50GB以上。如果你使用的是虚拟机，记得提前调整虚拟磁盘大小。我遇到过好几次因为空间不足导致编译失败的情况，最后只能重头再来。

显卡驱动也是容易踩坑的地方。运行Gazebo需要正确的显卡驱动支持，建议使用以下命令安装NVIDIA官方驱动：

sudo ubuntu-drivers autoinstall

安装完成后记得重启，并用nvidia-smi命令验证驱动是否正常工作。去年帮学弟调试时，发现他用的开源驱动导致Gazebo渲染异常卡顿，换成官方驱动后流畅度直接提升三倍。

2. ROS安装：选择最适合XTDrone的版本

ROS是XTDrone的核心依赖，但版本选择很关键。经过多次测试，我发现ROS Noetic（对应Ubuntu20.04）是最稳定的选择。官方推荐的方法是用鱼香ROS的一键安装脚本：

wget http://fishros.com/install -O fishros && . fishros

这个脚本会自动处理所有依赖关系，比手动安装省心很多。记得我第一次手动安装ROS时，花了整整两天时间解决各种依赖冲突，而用这个脚本20分钟就搞定了。

安装完成后务必验证环境变量是否配置正确。我建议在终端执行：

source /opt/ros/noetic/setup.bash echo "source /opt/ros/noetic/setup.bash" >> ~/.bashrc

有个常见问题是多版本ROS共存导致的环境污染。如果你之前安装过其他ROS版本，最好先完全卸载。去年实验室的测试机上就因为这个原因导致XTDrone无法正常启动，清理旧版本后才解决。

3. Gazebo安装：版本控制的艺术

Gazebo版本是最大的雷区之一。XTDrone官方推荐使用Gazebo9，但Ubuntu20.04默认仓库中是Gazebo11。经过多次踩坑，我发现最可靠的方法是：

sudo sh -c 'echo "deb http://packages.osrfoundation.org/gazebo/ubuntu-stable `lsb_release -cs` main" > /etc/apt/sources.list.d/gazebo-stable.list' wget https://packages.osrfoundation.org/gazebo.key -O - | sudo apt-key add - sudo apt update sudo apt install gazebo9 libgazebo9-dev -y

安装后立即锁定版本，防止意外升级：

sudo apt-mark hold gazebo9 libgazebo9-dev

模型下载是另一个痛点。Gazebo首次启动时会下载大量模型文件，国内网络环境经常失败。我整理了完整的模型包，可以通过以下命令快速安装：

wget https://gitee.com/robin_shaun/XTDrone/releases/download/v1.0/gazebo_models.tar.gz tar -xzf gazebo_models.tar.gz -C ~/.gazebo/

4. MAVROS安装：解决依赖地狱

MAVROS是连接ROS和PX4的桥梁，但它的依赖关系相当复杂。最稳妥的安装方式是：

sudo apt install ros-noetic-mavros ros-noetic-mavros-extras -y wget https://raw.githubusercontent.com/mavlink/mavros/master/mavros/scripts/install_geographiclib_datasets.sh chmod +x install_geographiclib_datasets.sh sudo ./install_geographiclib_datasets.sh

这里有个隐藏坑点：地理信息数据集安装需要科学上网。如果遇到下载失败，可以手动下载后解压到/usr/share/GeographicLib目录。上个月给客户部署时就遇到了这个问题，最后是通过内网镜像解决的。

验证MAVROS是否安装成功：

roslaunch mavros px4.launch

如果看到终端输出心跳信息，说明安装正确。我遇到过因为Python包冲突导致启动失败的情况，用pip uninstall pymavlink后再重新安装ROS版的pymavlink就解决了。

5. PX4固件编译：避开版本陷阱

PX4的版本选择直接影响XTDrone的稳定性。经过多次测试，我强烈建议使用PX4 v1.13.0稳定版：

git clone --recursive https://github.com/PX4/PX4-Autopilot.git -b v1.13.0 cd PX4-Autopilot make px4_sitl_default gazebo

编译过程可能会遇到内存不足的问题。如果机器配置较低，可以尝试：

make px4_sitl_default gazebo -j2

去年在树莓派上编译时，发现默认的并行编译会导致内存溢出，加上-j2参数限制并行任务数后就顺利通过了。

常见错误处理：

1. 如果出现"git submodule"相关错误，执行：

   git submodule sync --recursive git submodule update --init --recursive

2. 遇到Python包缺失时，用pip安装：

   pip install numpy toml pandas jinja2 pyyaml

6. XTDrone部署：最后的冲刺

XTDrone本体的安装相对简单，但有几个细节需要注意：

mkdir -p ~/xtdrone_ws/src cd ~/xtdrone_ws/src git clone https://gitee.com/robin_shaun/XTDrone.git cd .. catkin_make

编译完成后，记得更新环境变量：

echo "source ~/xtdrone_ws/devel/setup.bash" >> ~/.bashrc source ~/.bashrc

测试运行时可能会遇到模型路径问题，解决方法是在launch文件中添加：

<env name="GAZEBO_MODEL_PATH" value="${GAZEBO_MODEL_PATH}:$(find px4)/Tools/sitl_gazebo/models"/>

上周在给新笔记本部署时，发现因为屏幕缩放导致Gazebo界面显示异常，解决方法是在启动命令前加上：

export QT_AUTO_SCREEN_SCALE_FACTOR=0

7. 常见问题排查指南

经过数十次部署实践，我整理了这份高频问题排查清单：

1. Gazebo黑屏无响应：

   • 检查显卡驱动：glxinfo | grep "OpenGL renderer"
   • 尝试软件渲染：export LIBGL_ALWAYS_SOFTWARE=1

2. ROS节点通信失败：

   • 检查IP设置：echo $ROS_IP
   • 验证主机名解析：ping $(hostname)

3. PX4无法解锁：

   • 检查MAVROS连接：rostopic echo /mavros/state
   • 验证遥控器校准：rosrun mavros mavsys mode -c MANUAL

4. 模型加载异常：

   • 清理Gazebo缓存：rm -rf ~/.gazebo/*
   • 重新下载模型：rosrun gazebo_ros spawn_model

记得去年有次部署后一切正常，但第二天启动时Gazebo突然崩溃。最后发现是NVIDIA驱动自动更新导致的，回滚驱动后解决。建议禁用自动更新：

sudo apt-mark hold nvidia-driver-*