1. 环境准备别急着敲命令先理清思路大家好我是老张一个在机器人仿真领域摸爬滚打了十来年的工程师。今天咱们不聊那些高深的理论就手把手地带你把一个叫XTDrone的无人机仿真平台从零开始完完整整地装到你的电脑上。我知道很多新手朋友一看到“环境搭建”四个字就头疼网上教程一大堆但照着做总是卡在某个莫名其妙的错误上最后只能放弃。别担心这篇文章就是为你准备的“实战排坑指南”。我会把每一步的原理、可能遇到的坑以及我亲自踩过并填平的解决方案都掰开揉碎了讲给你听。XTDrone是什么简单说它是一个基于ROS、Gazebo和PX4飞控的无人机仿真平台。你可以把它想象成一个“无人机元宇宙”在这里你不需要花真金白银买无人机也不用担心炸机就能测试你的控制算法、视觉导航、集群编队等各种酷炫想法。它非常适合高校学生、科研人员和算法工程师做前期验证和开发。我们今天的目标就是在Ubuntu 20.04系统上搭建一个与PX4 v1.13.2固件版本匹配的XTDrone仿真环境。整个过程就像搭积木我们一块一块来顺序很重要一块放错了后面可能全塌。所以请务必跟着我的步骤走。在开始之前我强烈建议你做好两件事第一备份好你电脑里的重要资料。虽然我们的操作一般不会影响到个人文件但以防万一。第二确保你的Ubuntu系统已经更新到最新状态打开终端输入sudo apt update sudo apt upgrade喝杯茶等它完成。这能避免很多因系统包过旧导致的依赖冲突。好了废话不多说咱们从最基础的依赖安装开始。2. 系统依赖与ROS安装打好地基避开网络“深坑”2.1 系统依赖安装看似简单实则关键很多教程把依赖安装一笔带过但这里恰恰是第一个容易翻车的地方。XTDrone编译和运行需要一堆工具和库缺一个都可能导致后续编译失败。我们打开终端一次性安装它们。这里我给出的命令和官方略有不同我增加了一些我实践中发现必需的包并且调整了顺序以优化安装体验。sudo apt install -y ninja-build exiftool protobuf-compiler libeigen3-dev genromfs xmlstarlet libgstreamer1.0-dev libgstreamer-plugins-base1.0-dev gawk python3-pip这条命令里的-y参数是为了让系统自动确认安装省去我们手动输入“Y”的步骤。ninja-build是一个比传统make更快的构建系统PX4用它来编译。eigen3是数学计算库机器人领域离不开它。gstreamer系列是多媒体框架Gazebo仿真渲染可能会用到。系统包安装完后我们还需要通过Python的pip工具安装一些Python依赖。这里有个小坑务必使用pip3而不是pip因为Ubuntu 20.04默认的Python3是主版本pip命令可能指向已不存在的Python2。我们明确使用pip3pip3 install packaging numpy empy toml pyyaml jinja2 pyargparse kconfiglib jsonschema future如果系统提示pip3命令未找到那就先安装它sudo apt install python3-pip。安装这些Python包时如果速度慢可以考虑临时更换国内的PyPI镜像源比如清华源但这步不是必须的网络好的同学可以忽略。2.2 ROS Noetic安装善用国内资源告别“rosdep init”噩梦ROS是机器人操作系统的核心我们的仿真节点都靠它来通信。Ubuntu 20.04对应的是ROS Noetic版本。官方推荐去ROS Wiki照着步骤安装但这里最大的“拦路虎”就是著名的sudo rosdep init和rosdep update。由于众所周知的原因这两条命令在国内网络环境下失败率高达90%。以前我们得折腾各种修改hosts文件、换源的方法麻烦且不稳定。现在我推荐你直接用“鱼香ROS”提供的一键安装工具这是国内ROS社区的大神做的完美解决了网络问题。别再去硬刚官方源了咱们用更高效的办法。首先确保你安装了rosdepc所需的工具sudo pip3 install rosdepc如果pip3安装很慢同样可以考虑换源。安装成功后用下面两条命令替代官方的rosdep init/updatesudo rosdepc init rosdepc update看就这么简单。rosdepc会自动使用国内的镜像源速度飞快基本一次成功。完成这步后再按照ROS Wiki的步骤安装ROS Noetic桌面完整版。在终端里依次执行sudo sh -c echo deb http://packages.ros.org/ros/ubuntu $(lsb_release -sc) main /etc/apt/sources.list.d/ros-latest.list sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv-key C1CF6E31E6BADE8868B172B4F42ED6FBAB17C654 sudo apt update sudo apt install ros-noetic-desktop-full安装过程比较长取决于你的网速可以去处理点别的事情。安装完成后别忘了把ROS环境变量加到你的bashrc里这样每次打开终端ROS命令都可用echo source /opt/ros/noetic/setup.bash ~/.bashrc source ~/.bashrc为了验证ROS是否安装成功可以打开一个新终端输入roscore。如果看到它开始运行没有报错并且显示一个ROS Master的地址那就说明ROS基础环境OK了。按CtrlC停止它。这一步地基打牢了后面盖房子才稳。3. 仿真引擎与飞控配置Gazebo和PX4的“联姻”3.1 Gazebo 11安装卸载干净安装到位Gazebo是我们的仿真世界引擎负责渲染物理环境。XTDrone推荐使用Gazebo 9但经过我的实测在Ubuntu 20.04上Gazebo 11的兼容性和稳定性更好。安装前务必彻底清理旧版本否则版本冲突会让你怀疑人生。执行以下清理命令sudo apt-get remove gazebo* libgazebo* ros-noetic-gazebo* -y清理完成后我们添加Gazebo官方源来安装Gazebo 11。这里注意如果你之前添加过其他版本的Gazebo源最好先检查一下/etc/apt/sources.list.d/目录下的相关文件。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-get update现在安装Gazebo 11本体和开发库sudo apt-get install gazebo11 libgazebo11-dev -y安装完成后验证一下。在终端输入gazebo并回车。第一次启动可能会慢一点因为它要下载一些模型。如果成功弹出一个灰色的3D世界窗口说明Gazebo安装成功。你可以关掉它了。有时候模型下载慢会导致窗口卡住你可以直接关掉不影响后续模型会在后台继续下载。3.2 PX4飞控固件配置版本锁定与首次编译PX4是无人机的“大脑”即飞控软件。XTDrone需要特定版本的PX4固件v1.13.2才能正常工作。这一步的克隆和编译是整个过程里最耗时也最容易出错的环节。首先我们把PX4的源码克隆下来。注意官方仓库在国外国内克隆可能很慢甚至失败。别急我们可以用国内镜像比如Gitee上的镜像。但为了和后续XTDrone的插件完美匹配我们这里还是使用官方源如果你网络实在不行再考虑找镜像。git clone https://github.com/PX4/PX4-Autopilot.git cd PX4-Autopilot克隆完成后目录名是PX4-Autopilot但很多老教程和XTDrone的脚本里习惯称它为PX4_Firmware。为了避免路径 confusion我建议你按XTDrone的约定重命名一下cd .. mv PX4-Autopilot PX4_Firmware cd PX4_Firmware关键一步来了切换分支。我们必须严格切换到v1.13.2这个标签对应的版本。使用以下命令git checkout -b xtdrone/dev v1.13.2这条命令创建了一个名为xtdrone/dev的新分支并让它指向v1.13.2这个标签。这样我们就有了一个干净的工作分支。接下来初始化并更新子模块这里包含了PX4依赖的很多第三方库如uORB、DriverFramework等必不可少git submodule update --init --recursive子模块更新可能会很慢因为要拉取很多小仓库耐心等待。全部完成后就可以进行第一次编译了。我们编译的目标是px4_sitl_default软件在环仿真并指定用gazebo作为前端。make px4_sitl_default gazebo编译过程会持续一段时间第一次编译可能会下载一些工具链电脑风扇狂转是正常的。如果最终编译成功你会看到Gazebo自动启动并加载一个带有IRIS无人机模型的世界。恭喜你PX4固件部分基本搞定先关掉Gazebo窗口。3.3 环境变量配置让系统找到你的“零件”编译成功只是第一步要让ROS、Gazebo和PX4三者能互相找到、协同工作必须正确设置环境变量。这就像告诉一个组装工人发动机、轮子和方向盘分别放在哪个仓库。我们需要编辑用户主目录下的.bashrc文件。打开终端输入gedit ~/.bashrc或者用你喜欢的文本编辑器如nano、vim。翻到文件最末尾添加以下几行。请注意你需要根据自己实际的目录路径来修改下面假设你的PX4_Firmware和catkin_wsROS工作空间都放在用户主目录~下。# 加载ROS环境 source ~/catkin_ws/devel/setup.bash # 加载PX4的Gazebo环境设置 source ~/PX4_Firmware/Tools/setup_gazebo.bash ~/PX4_Firmware/ ~/PX4_Firmware/build/px4_sitl_default # 将PX4相关路径添加到ROS的包路径中 export ROS_PACKAGE_PATH$ROS_PACKAGE_PATH:~/PX4_Firmware export ROS_PACKAGE_PATH$ROS_PACKAGE_PATH:~/PX4_Firmware/Tools/sitl_gazebo添加完成后保存文件并关闭编辑器。回到终端执行source ~/.bashrc让配置立即生效。现在我们来验证一下环境变量是否起作用。在一个新的终端中依次输入以下命令cd ~/PX4_Firmware roslaunch px4 mavros_posix_sitl.launch如果一切顺利你会看到两个窗口一个终端里PX4飞控软件在启动打印很多状态信息另一个是Gazebo窗口里面有一个无人机停在空地上。同时你应该能看到关于MAVROS连接ROS和飞控的桥梁启动成功的提示。这说明ROS、Gazebo、PX4这三兄弟已经成功牵手了。按CtrlC可以终止这个测试。4. MAVROS与XTDrone部署搭建通信桥梁与功能模块4.1 MAVROS安装与地理数据库耐心等待的“数据包”MAVROS是ROS和PX4飞控使用MAVLink协议通信的ROS功能包。没有它你的ROS节点就无法给无人机发送指令或读取传感器数据。安装它本身很简单sudo apt install ros-noetic-mavros ros-noetic-mavros-extras -y但安装完主包后还有一个至关重要的步骤安装地理数据库GeographicLib datasets。这个数据库用于提供高精度的地理信息转换比如经纬度、高度对于无人机导航至关重要。MAVROS提供了一个脚本来自动下载安装但这个脚本下载的数据源在国外速度极慢且容易中断。脚本通常可以通过以下方式获取并运行wget https://gitee.com/robin_shaun/XTDrone/raw/master/sitl_config/mavros/install_geographiclib_datasets.sh chmod x install_geographiclib_datasets.sh sudo ./install_geographiclib_datasets.sh如果你运行脚本卡住或者报错别慌。这几乎是每个新手都会遇到的问题。解决办法是手动下载数据包。你可以搜索“GeographicLib datasets 离线安装”找到国内社区分享的压缩包通常叫geographiclib-datasets-1.50.tar.gz之类的。下载后解压到/usr/share/GeographicLib/目录下可能需要sudo权限。确保解压后该目录下有geoids、gravity、magnetic等子文件夹。手动放置好后就相当于跳过了那个漫长的脚本下载过程。4.2 XTDrone源码部署文件拷贝的艺术XTDrone的核心功能比如多机控制、键盘控制、视觉示例等都在这部分源码里。更重要的是它包含了一些针对PX4 v1.13.2修改过的插件和配置文件必须正确覆盖到PX4的目录中仿真才能有完整功能。首先克隆XTDrone的源码仓库。这里我们使用Gitee上的镜像速度会快很多git clone https://gitee.com/robin_shaun/XTDrone.git cd XTDrone同样我们需要切换到与PX4固件匹配的分支。对于PX4 v1.13.2XTDrone对应的分支通常是1_13_2git checkout 1_13_2 git submodule update --init --recursive接下来是一系列的文件拷贝操作这是整个搭建过程中最精细、最容易出错的一步。请睁大眼睛一条一条命令核对确保源路径和目标路径都正确。这些命令的作用是将XTDrone中定制化的仿真世界、启动文件、Gazebo插件等替换PX4中原有的文件。# 拷贝初始化脚本到PX4 cp sitl_config/init.d-posix/* ~/PX4_Firmware/ROMFS/px4fmu_common/init.d-posix/ # 拷贝ROS启动文件到PX4 cp -r sitl_config/launch/* ~/PX4_Firmware/launch/ # 拷贝仿真世界文件如室内、室外场景 cp sitl_config/worlds/* ~/PX4_Firmware/Tools/sitl_gazebo/worlds/ # 拷贝云台控制器插件用于搭载相机的无人机 cp sitl_config/gazebo_plugin/gimbal_controller/gazebo_gimbal_controller_plugin.cpp ~/PX4_Firmware/Tools/sitl_gazebo/src cp sitl_config/gazebo_plugin/gimbal_controller/gazebo_gimbal_controller_plugin.hh ~/PX4_Firmware/Tools/sitl_gazebo/include # 拷贝风场插件模拟风的环境影响 cp sitl_config/gazebo_plugin/wind_plugin/gazebo_ros_wind_plugin_xtdrone.cpp ~/PX4_Firmware/Tools/sitl_gazebo/src cp sitl_config/gazebo_plugin/wind_plugin/gazebo_ros_wind_plugin_xtdrone.h ~/PX4_Firmware/Tools/sitl_gazebo/include # 覆盖CMake构建配置文件 cp sitl_config/CMakeLists.txt ~/PX4_Firmware/Tools/sitl_gazebo # 拷贝额外的3D模型如障碍物、目标物 cp -r sitl_config/models/* ~/PX4_Firmware/Tools/sitl_gazebo/models/重要提示因为替换了关键的插件源文件和CMakeLists.txtPX4的Gazebo部分必须重新编译。而且为了编译的彻底性我建议先删除之前的编译缓存避免链接错误。cd ~/PX4_Firmware rm -rf build/ make px4_sitl_default gazebo这将是第二次编译速度会比第一次快因为它只编译有变动的部分。请确保这次编译没有报错。如果出现“未定义的引用”之类的编译错误大概率是文件拷贝的路径不对或者漏掉了某个拷贝步骤请回头仔细检查。5. 全系统联调与验证让你的无人机飞起来5.1 启动仿真世界与通信测试经过漫长的安装和配置现在到了最激动人心的时刻让仿真无人机动起来我们分步启动各个模块并观察它们之间的通信是否正常。首先启动仿真世界。我们打开一个终端这个终端将运行Gazebo环境和PX4飞控cd ~/PX4_Firmware roslaunch px4 indoor1.launch这条命令会启动一个室内的仿真环境indoor1里面有一个准备好的无人机。稍等片刻你会看到Gazebo窗口弹出显示一个室内仓库场景中央停着一架四旋翼无人机Iris模型。同时启动飞控的终端会刷出很多状态信息直到看到类似INFO [commander] Armed等字样表示飞控准备就绪。注意第一次启动某个世界时Gazebo可能会下载模型导致窗口卡住或黑屏。这是正常的等待几分钟即可。如果长时间没反应可以关掉重试通常第二次就好了。仿真世界运行起来后我们需要建立ROS节点与无人机之间的通信。打开第二个终端运行XTDrone提供的通信脚本cd ~/XTDrone/communication/ python3 multirotor_communication.py iris 0这条命令启动了与第一个编号0Iris无人机的通信桥接。如果成功你会在这个终端里看到周期性的消息打印比如[INFO] Connected to iris_0以及持续更新的姿态、位置等信息。这证明你的ROS节点已经通过MAVROS成功连接到了PX4飞控数据通道是畅通的。5.2 键盘控制与飞行测试通信建立后我们就可以发送指令控制无人机了。XTDrone提供了一个非常方便的上手工具——键盘控制。打开第三个终端运行键盘控制节点cd ~/XTDrone/control/keyboard python3 multirotor_keyboard_control.py iris 1 vel这条命令的含义是准备用键盘控制编号为1的无人机注意这里编号是1因为通信脚本里我们连接的是iris 0在控制脚本里iris 1对应的是同一个无人机这是XTDrone内部的一种映射按它的规矩来就行控制模式为速度控制vel。运行后控制终端会显示一个简单的操作说明比如Use arrow keys to control the drone. W/S: increase/decrease altitude. Q/E: yaw left/right. R: reset to hover. C: change control mode.现在将鼠标焦点点击到这个键盘控制终端上然后你就可以按键盘上的方向键等来控制无人机了比如按一下“上箭头”你应该能在Gazebo窗口中看到无人机开始向前飞行。按‘W’键无人机会上升。这就是最直接的验证说明从底层飞控、仿真环境、通信链路到上层控制节点整个链条全部打通了5.3 常见问题排查与解决思路在实际操作中你可能会遇到一些我上面没提到的问题。这里我总结几个最常见的“坑”和解决思路Gazebo黑屏或卡在加载界面99%是模型下载问题。可以手动下载模型包。在网上搜索“Gazebo models 离线包”下载后解压到~/.gazebo/models/目录下。也可以临时在Gazebo窗口左上角的“Insert”标签页里随便拖一个简单模型如Cube到世界如果能显示就说明Gazebo本身是好的只是默认世界模型没下载完。运行roslaunch px4 indoor1.launch报错找不到launch文件这通常是因为环境变量ROS_PACKAGE_PATH没有正确包含PX4的路径。请回头仔细检查你~/.bashrc文件中的那两行export ROS_PACKAGE_PATH...命令确保路径完全正确并且执行了source ~/.bashrc。可以用echo $ROS_PACKAGE_PATH命令查看当前路径是否包含了PX4的目录。通信脚本报错无法连接到飞控首先确保第一个终端运行roslaunch px4 indoor1.launch的没有报错且正常运行。然后检查MAVROS是否安装成功可以尝试运行rosrun mavros mavsys --help看是否有输出。最后检查通信脚本里的参数确保无人机类型iris和编号0正确。键盘控制没反应最常见的原因是你没有把键盘输入焦点放在运行控制脚本的终端窗口上。点击一下那个终端再按键盘。另外确认你按的是正确的键并且控制终端没有显示“Disconnected”之类的错误信息。编译PX4时出现“Permission denied”或“找不到命令”确保你在普通用户下操作并且拥有对PX4_Firmware目录的读写权限。如果之前用过sudo编译可能导致目录权限混乱可以尝试用sudo chown -R $USER:$USER ~/PX4_Firmware修改目录所有者。整个环境搭建就像完成一个精密的机械组装每一步都环环相扣。我第一次搭的时候也花了整整两天踩遍了几乎所有能踩的坑。但只要你严格按照步骤遇到错误别慌仔细看终端报错信息错误信息通常是解决问题的钥匙大部分问题都能在网上找到答案或者根据错误提示推断出来。当你终于看到无人机在仿真世界里按照你的键盘指令稳稳飞行时那种成就感会让你觉得之前所有的折腾都是值得的。这个环境将成为你探索无人机算法世界的强大沙盒祝你玩得开心创造出有趣的东西
XTDrone仿真平台：从零到一的完整环境搭建实战
发布时间：2026/7/4 21:59:25
1. 环境准备别急着敲命令先理清思路大家好我是老张一个在机器人仿真领域摸爬滚打了十来年的工程师。今天咱们不聊那些高深的理论就手把手地带你把一个叫XTDrone的无人机仿真平台从零开始完完整整地装到你的电脑上。我知道很多新手朋友一看到“环境搭建”四个字就头疼网上教程一大堆但照着做总是卡在某个莫名其妙的错误上最后只能放弃。别担心这篇文章就是为你准备的“实战排坑指南”。我会把每一步的原理、可能遇到的坑以及我亲自踩过并填平的解决方案都掰开揉碎了讲给你听。XTDrone是什么简单说它是一个基于ROS、Gazebo和PX4飞控的无人机仿真平台。你可以把它想象成一个“无人机元宇宙”在这里你不需要花真金白银买无人机也不用担心炸机就能测试你的控制算法、视觉导航、集群编队等各种酷炫想法。它非常适合高校学生、科研人员和算法工程师做前期验证和开发。我们今天的目标就是在Ubuntu 20.04系统上搭建一个与PX4 v1.13.2固件版本匹配的XTDrone仿真环境。整个过程就像搭积木我们一块一块来顺序很重要一块放错了后面可能全塌。所以请务必跟着我的步骤走。在开始之前我强烈建议你做好两件事第一备份好你电脑里的重要资料。虽然我们的操作一般不会影响到个人文件但以防万一。第二确保你的Ubuntu系统已经更新到最新状态打开终端输入sudo apt update sudo apt upgrade喝杯茶等它完成。这能避免很多因系统包过旧导致的依赖冲突。好了废话不多说咱们从最基础的依赖安装开始。2. 系统依赖与ROS安装打好地基避开网络“深坑”2.1 系统依赖安装看似简单实则关键很多教程把依赖安装一笔带过但这里恰恰是第一个容易翻车的地方。XTDrone编译和运行需要一堆工具和库缺一个都可能导致后续编译失败。我们打开终端一次性安装它们。这里我给出的命令和官方略有不同我增加了一些我实践中发现必需的包并且调整了顺序以优化安装体验。sudo apt install -y ninja-build exiftool protobuf-compiler libeigen3-dev genromfs xmlstarlet libgstreamer1.0-dev libgstreamer-plugins-base1.0-dev gawk python3-pip这条命令里的-y参数是为了让系统自动确认安装省去我们手动输入“Y”的步骤。ninja-build是一个比传统make更快的构建系统PX4用它来编译。eigen3是数学计算库机器人领域离不开它。gstreamer系列是多媒体框架Gazebo仿真渲染可能会用到。系统包安装完后我们还需要通过Python的pip工具安装一些Python依赖。这里有个小坑务必使用pip3而不是pip因为Ubuntu 20.04默认的Python3是主版本pip命令可能指向已不存在的Python2。我们明确使用pip3pip3 install packaging numpy empy toml pyyaml jinja2 pyargparse kconfiglib jsonschema future如果系统提示pip3命令未找到那就先安装它sudo apt install python3-pip。安装这些Python包时如果速度慢可以考虑临时更换国内的PyPI镜像源比如清华源但这步不是必须的网络好的同学可以忽略。2.2 ROS Noetic安装善用国内资源告别“rosdep init”噩梦ROS是机器人操作系统的核心我们的仿真节点都靠它来通信。Ubuntu 20.04对应的是ROS Noetic版本。官方推荐去ROS Wiki照着步骤安装但这里最大的“拦路虎”就是著名的sudo rosdep init和rosdep update。由于众所周知的原因这两条命令在国内网络环境下失败率高达90%。以前我们得折腾各种修改hosts文件、换源的方法麻烦且不稳定。现在我推荐你直接用“鱼香ROS”提供的一键安装工具这是国内ROS社区的大神做的完美解决了网络问题。别再去硬刚官方源了咱们用更高效的办法。首先确保你安装了rosdepc所需的工具sudo pip3 install rosdepc如果pip3安装很慢同样可以考虑换源。安装成功后用下面两条命令替代官方的rosdep init/updatesudo rosdepc init rosdepc update看就这么简单。rosdepc会自动使用国内的镜像源速度飞快基本一次成功。完成这步后再按照ROS Wiki的步骤安装ROS Noetic桌面完整版。在终端里依次执行sudo sh -c echo deb http://packages.ros.org/ros/ubuntu $(lsb_release -sc) main /etc/apt/sources.list.d/ros-latest.list sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv-key C1CF6E31E6BADE8868B172B4F42ED6FBAB17C654 sudo apt update sudo apt install ros-noetic-desktop-full安装过程比较长取决于你的网速可以去处理点别的事情。安装完成后别忘了把ROS环境变量加到你的bashrc里这样每次打开终端ROS命令都可用echo source /opt/ros/noetic/setup.bash ~/.bashrc source ~/.bashrc为了验证ROS是否安装成功可以打开一个新终端输入roscore。如果看到它开始运行没有报错并且显示一个ROS Master的地址那就说明ROS基础环境OK了。按CtrlC停止它。这一步地基打牢了后面盖房子才稳。3. 仿真引擎与飞控配置Gazebo和PX4的“联姻”3.1 Gazebo 11安装卸载干净安装到位Gazebo是我们的仿真世界引擎负责渲染物理环境。XTDrone推荐使用Gazebo 9但经过我的实测在Ubuntu 20.04上Gazebo 11的兼容性和稳定性更好。安装前务必彻底清理旧版本否则版本冲突会让你怀疑人生。执行以下清理命令sudo apt-get remove gazebo* libgazebo* ros-noetic-gazebo* -y清理完成后我们添加Gazebo官方源来安装Gazebo 11。这里注意如果你之前添加过其他版本的Gazebo源最好先检查一下/etc/apt/sources.list.d/目录下的相关文件。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-get update现在安装Gazebo 11本体和开发库sudo apt-get install gazebo11 libgazebo11-dev -y安装完成后验证一下。在终端输入gazebo并回车。第一次启动可能会慢一点因为它要下载一些模型。如果成功弹出一个灰色的3D世界窗口说明Gazebo安装成功。你可以关掉它了。有时候模型下载慢会导致窗口卡住你可以直接关掉不影响后续模型会在后台继续下载。3.2 PX4飞控固件配置版本锁定与首次编译PX4是无人机的“大脑”即飞控软件。XTDrone需要特定版本的PX4固件v1.13.2才能正常工作。这一步的克隆和编译是整个过程里最耗时也最容易出错的环节。首先我们把PX4的源码克隆下来。注意官方仓库在国外国内克隆可能很慢甚至失败。别急我们可以用国内镜像比如Gitee上的镜像。但为了和后续XTDrone的插件完美匹配我们这里还是使用官方源如果你网络实在不行再考虑找镜像。git clone https://github.com/PX4/PX4-Autopilot.git cd PX4-Autopilot克隆完成后目录名是PX4-Autopilot但很多老教程和XTDrone的脚本里习惯称它为PX4_Firmware。为了避免路径 confusion我建议你按XTDrone的约定重命名一下cd .. mv PX4-Autopilot PX4_Firmware cd PX4_Firmware关键一步来了切换分支。我们必须严格切换到v1.13.2这个标签对应的版本。使用以下命令git checkout -b xtdrone/dev v1.13.2这条命令创建了一个名为xtdrone/dev的新分支并让它指向v1.13.2这个标签。这样我们就有了一个干净的工作分支。接下来初始化并更新子模块这里包含了PX4依赖的很多第三方库如uORB、DriverFramework等必不可少git submodule update --init --recursive子模块更新可能会很慢因为要拉取很多小仓库耐心等待。全部完成后就可以进行第一次编译了。我们编译的目标是px4_sitl_default软件在环仿真并指定用gazebo作为前端。make px4_sitl_default gazebo编译过程会持续一段时间第一次编译可能会下载一些工具链电脑风扇狂转是正常的。如果最终编译成功你会看到Gazebo自动启动并加载一个带有IRIS无人机模型的世界。恭喜你PX4固件部分基本搞定先关掉Gazebo窗口。3.3 环境变量配置让系统找到你的“零件”编译成功只是第一步要让ROS、Gazebo和PX4三者能互相找到、协同工作必须正确设置环境变量。这就像告诉一个组装工人发动机、轮子和方向盘分别放在哪个仓库。我们需要编辑用户主目录下的.bashrc文件。打开终端输入gedit ~/.bashrc或者用你喜欢的文本编辑器如nano、vim。翻到文件最末尾添加以下几行。请注意你需要根据自己实际的目录路径来修改下面假设你的PX4_Firmware和catkin_wsROS工作空间都放在用户主目录~下。# 加载ROS环境 source ~/catkin_ws/devel/setup.bash # 加载PX4的Gazebo环境设置 source ~/PX4_Firmware/Tools/setup_gazebo.bash ~/PX4_Firmware/ ~/PX4_Firmware/build/px4_sitl_default # 将PX4相关路径添加到ROS的包路径中 export ROS_PACKAGE_PATH$ROS_PACKAGE_PATH:~/PX4_Firmware export ROS_PACKAGE_PATH$ROS_PACKAGE_PATH:~/PX4_Firmware/Tools/sitl_gazebo添加完成后保存文件并关闭编辑器。回到终端执行source ~/.bashrc让配置立即生效。现在我们来验证一下环境变量是否起作用。在一个新的终端中依次输入以下命令cd ~/PX4_Firmware roslaunch px4 mavros_posix_sitl.launch如果一切顺利你会看到两个窗口一个终端里PX4飞控软件在启动打印很多状态信息另一个是Gazebo窗口里面有一个无人机停在空地上。同时你应该能看到关于MAVROS连接ROS和飞控的桥梁启动成功的提示。这说明ROS、Gazebo、PX4这三兄弟已经成功牵手了。按CtrlC可以终止这个测试。4. MAVROS与XTDrone部署搭建通信桥梁与功能模块4.1 MAVROS安装与地理数据库耐心等待的“数据包”MAVROS是ROS和PX4飞控使用MAVLink协议通信的ROS功能包。没有它你的ROS节点就无法给无人机发送指令或读取传感器数据。安装它本身很简单sudo apt install ros-noetic-mavros ros-noetic-mavros-extras -y但安装完主包后还有一个至关重要的步骤安装地理数据库GeographicLib datasets。这个数据库用于提供高精度的地理信息转换比如经纬度、高度对于无人机导航至关重要。MAVROS提供了一个脚本来自动下载安装但这个脚本下载的数据源在国外速度极慢且容易中断。脚本通常可以通过以下方式获取并运行wget https://gitee.com/robin_shaun/XTDrone/raw/master/sitl_config/mavros/install_geographiclib_datasets.sh chmod x install_geographiclib_datasets.sh sudo ./install_geographiclib_datasets.sh如果你运行脚本卡住或者报错别慌。这几乎是每个新手都会遇到的问题。解决办法是手动下载数据包。你可以搜索“GeographicLib datasets 离线安装”找到国内社区分享的压缩包通常叫geographiclib-datasets-1.50.tar.gz之类的。下载后解压到/usr/share/GeographicLib/目录下可能需要sudo权限。确保解压后该目录下有geoids、gravity、magnetic等子文件夹。手动放置好后就相当于跳过了那个漫长的脚本下载过程。4.2 XTDrone源码部署文件拷贝的艺术XTDrone的核心功能比如多机控制、键盘控制、视觉示例等都在这部分源码里。更重要的是它包含了一些针对PX4 v1.13.2修改过的插件和配置文件必须正确覆盖到PX4的目录中仿真才能有完整功能。首先克隆XTDrone的源码仓库。这里我们使用Gitee上的镜像速度会快很多git clone https://gitee.com/robin_shaun/XTDrone.git cd XTDrone同样我们需要切换到与PX4固件匹配的分支。对于PX4 v1.13.2XTDrone对应的分支通常是1_13_2git checkout 1_13_2 git submodule update --init --recursive接下来是一系列的文件拷贝操作这是整个搭建过程中最精细、最容易出错的一步。请睁大眼睛一条一条命令核对确保源路径和目标路径都正确。这些命令的作用是将XTDrone中定制化的仿真世界、启动文件、Gazebo插件等替换PX4中原有的文件。# 拷贝初始化脚本到PX4 cp sitl_config/init.d-posix/* ~/PX4_Firmware/ROMFS/px4fmu_common/init.d-posix/ # 拷贝ROS启动文件到PX4 cp -r sitl_config/launch/* ~/PX4_Firmware/launch/ # 拷贝仿真世界文件如室内、室外场景 cp sitl_config/worlds/* ~/PX4_Firmware/Tools/sitl_gazebo/worlds/ # 拷贝云台控制器插件用于搭载相机的无人机 cp sitl_config/gazebo_plugin/gimbal_controller/gazebo_gimbal_controller_plugin.cpp ~/PX4_Firmware/Tools/sitl_gazebo/src cp sitl_config/gazebo_plugin/gimbal_controller/gazebo_gimbal_controller_plugin.hh ~/PX4_Firmware/Tools/sitl_gazebo/include # 拷贝风场插件模拟风的环境影响 cp sitl_config/gazebo_plugin/wind_plugin/gazebo_ros_wind_plugin_xtdrone.cpp ~/PX4_Firmware/Tools/sitl_gazebo/src cp sitl_config/gazebo_plugin/wind_plugin/gazebo_ros_wind_plugin_xtdrone.h ~/PX4_Firmware/Tools/sitl_gazebo/include # 覆盖CMake构建配置文件 cp sitl_config/CMakeLists.txt ~/PX4_Firmware/Tools/sitl_gazebo # 拷贝额外的3D模型如障碍物、目标物 cp -r sitl_config/models/* ~/PX4_Firmware/Tools/sitl_gazebo/models/重要提示因为替换了关键的插件源文件和CMakeLists.txtPX4的Gazebo部分必须重新编译。而且为了编译的彻底性我建议先删除之前的编译缓存避免链接错误。cd ~/PX4_Firmware rm -rf build/ make px4_sitl_default gazebo这将是第二次编译速度会比第一次快因为它只编译有变动的部分。请确保这次编译没有报错。如果出现“未定义的引用”之类的编译错误大概率是文件拷贝的路径不对或者漏掉了某个拷贝步骤请回头仔细检查。5. 全系统联调与验证让你的无人机飞起来5.1 启动仿真世界与通信测试经过漫长的安装和配置现在到了最激动人心的时刻让仿真无人机动起来我们分步启动各个模块并观察它们之间的通信是否正常。首先启动仿真世界。我们打开一个终端这个终端将运行Gazebo环境和PX4飞控cd ~/PX4_Firmware roslaunch px4 indoor1.launch这条命令会启动一个室内的仿真环境indoor1里面有一个准备好的无人机。稍等片刻你会看到Gazebo窗口弹出显示一个室内仓库场景中央停着一架四旋翼无人机Iris模型。同时启动飞控的终端会刷出很多状态信息直到看到类似INFO [commander] Armed等字样表示飞控准备就绪。注意第一次启动某个世界时Gazebo可能会下载模型导致窗口卡住或黑屏。这是正常的等待几分钟即可。如果长时间没反应可以关掉重试通常第二次就好了。仿真世界运行起来后我们需要建立ROS节点与无人机之间的通信。打开第二个终端运行XTDrone提供的通信脚本cd ~/XTDrone/communication/ python3 multirotor_communication.py iris 0这条命令启动了与第一个编号0Iris无人机的通信桥接。如果成功你会在这个终端里看到周期性的消息打印比如[INFO] Connected to iris_0以及持续更新的姿态、位置等信息。这证明你的ROS节点已经通过MAVROS成功连接到了PX4飞控数据通道是畅通的。5.2 键盘控制与飞行测试通信建立后我们就可以发送指令控制无人机了。XTDrone提供了一个非常方便的上手工具——键盘控制。打开第三个终端运行键盘控制节点cd ~/XTDrone/control/keyboard python3 multirotor_keyboard_control.py iris 1 vel这条命令的含义是准备用键盘控制编号为1的无人机注意这里编号是1因为通信脚本里我们连接的是iris 0在控制脚本里iris 1对应的是同一个无人机这是XTDrone内部的一种映射按它的规矩来就行控制模式为速度控制vel。运行后控制终端会显示一个简单的操作说明比如Use arrow keys to control the drone. W/S: increase/decrease altitude. Q/E: yaw left/right. R: reset to hover. C: change control mode.现在将鼠标焦点点击到这个键盘控制终端上然后你就可以按键盘上的方向键等来控制无人机了比如按一下“上箭头”你应该能在Gazebo窗口中看到无人机开始向前飞行。按‘W’键无人机会上升。这就是最直接的验证说明从底层飞控、仿真环境、通信链路到上层控制节点整个链条全部打通了5.3 常见问题排查与解决思路在实际操作中你可能会遇到一些我上面没提到的问题。这里我总结几个最常见的“坑”和解决思路Gazebo黑屏或卡在加载界面99%是模型下载问题。可以手动下载模型包。在网上搜索“Gazebo models 离线包”下载后解压到~/.gazebo/models/目录下。也可以临时在Gazebo窗口左上角的“Insert”标签页里随便拖一个简单模型如Cube到世界如果能显示就说明Gazebo本身是好的只是默认世界模型没下载完。运行roslaunch px4 indoor1.launch报错找不到launch文件这通常是因为环境变量ROS_PACKAGE_PATH没有正确包含PX4的路径。请回头仔细检查你~/.bashrc文件中的那两行export ROS_PACKAGE_PATH...命令确保路径完全正确并且执行了source ~/.bashrc。可以用echo $ROS_PACKAGE_PATH命令查看当前路径是否包含了PX4的目录。通信脚本报错无法连接到飞控首先确保第一个终端运行roslaunch px4 indoor1.launch的没有报错且正常运行。然后检查MAVROS是否安装成功可以尝试运行rosrun mavros mavsys --help看是否有输出。最后检查通信脚本里的参数确保无人机类型iris和编号0正确。键盘控制没反应最常见的原因是你没有把键盘输入焦点放在运行控制脚本的终端窗口上。点击一下那个终端再按键盘。另外确认你按的是正确的键并且控制终端没有显示“Disconnected”之类的错误信息。编译PX4时出现“Permission denied”或“找不到命令”确保你在普通用户下操作并且拥有对PX4_Firmware目录的读写权限。如果之前用过sudo编译可能导致目录权限混乱可以尝试用sudo chown -R $USER:$USER ~/PX4_Firmware修改目录所有者。整个环境搭建就像完成一个精密的机械组装每一步都环环相扣。我第一次搭的时候也花了整整两天踩遍了几乎所有能踩的坑。但只要你严格按照步骤遇到错误别慌仔细看终端报错信息错误信息通常是解决问题的钥匙大部分问题都能在网上找到答案或者根据错误提示推断出来。当你终于看到无人机在仿真世界里按照你的键盘指令稳稳飞行时那种成就感会让你觉得之前所有的折腾都是值得的。这个环境将成为你探索无人机算法世界的强大沙盒祝你玩得开心创造出有趣的东西
![华为OD机试2025C卷-字符串变换最小次数[100分]（ Java _ Python3 _ C++ _ C语言 _ JsNode _ Go）实现100%通过率](http://pic.xiahunao.cn/yaotu/华为OD机试2025C卷-字符串变换最小次数[100分]（ Java _ Python3 _ C++ _ C语言 _ JsNode _ Go）实现100%通过率)
![华为OD机试2025C卷-内存资源分配[100分]（ Java _ Python3 _ C++ _ C语言 _ JsNode _ Go）实现100%通过率](http://pic.xiahunao.cn/yaotu/华为OD机试2025C卷-内存资源分配[100分]（ Java _ Python3 _ C++ _ C语言 _ JsNode _ Go）实现100%通过率)
