1. 为什么你需要一个本地的无人机仿真环境？

如果你对无人机开发感兴趣，或者正在学习ROS机器人操作系统，那么亲手搭建一个仿真环境，绝对是性价比最高的第一步。想象一下，你有一个想法，比如让无人机自动巡航、避障，或者测试一个新的控制算法。直接上真机？成本高、风险大，炸一次机可能半个月的饭钱就没了。而仿真环境，就像给你的创意提供了一个绝对安全的“数字沙盘”。

在这个沙盘里，你可以反复试错，零成本地验证你的代码逻辑。今天我们要搭建的，就是无人机圈子里最经典、最强大的组合之一：PX4飞控 + Gazebo仿真器 + ROS/MAVROS通信。PX4是开源飞控的标杆，提供了稳定可靠的飞行控制核心；Gazebo则是一个功能强大的物理仿真引擎，能模拟出逼真的无人机模型、传感器数据和物理环境（比如风、重力）；而ROS和MAVROS，就是连接你写的智能算法与这个仿真世界的“神经系统”和“翻译官”。

我当年刚开始玩的时候，也被网上各种零散的教程搞得头大，不是依赖报错，就是编译失败，光一个环境就能卡好几天。所以，这篇文章我会把我自己在Ubuntu 20.04上趟过的路、踩过的坑，从头到尾、手把手地复现一遍。我们的目标很明确：从一台干净的Ubuntu 20.04系统开始，最终让你能亲眼看到一架仿真无人机在Gazebo里稳稳起飞。整个过程我会尽量解释清楚每一步在干什么，遇到常见错误怎么解决，让你不仅知其然，更知其所以然。

2. 基石：准备好你的Ubuntu 20.04工作站

万事开头难，但把基础打牢，后面就能事半功倍。这里我强烈建议，如果你主要目的是学习和开发，直接在你的物理机上安装Ubuntu 20.04，而不是用虚拟机。虚拟机的3D图形加速和性能往往是个大坑，跑Gazebo这种图形化仿真很容易卡顿甚至失败。当然，如果你的电脑配置足够强悍（比如32G内存，好的独立显卡），用虚拟机也不是不行，但物理机永远是第一选择。

2.1 系统更新与基础工具安装

打开终端，我们首先确保系统是最新的，并安装一些后续肯定会用到的工具。

sudo apt update
sudo apt upgrade -y
sudo apt install -y curl wget git vim net-tools

apt update是刷新软件源列表，upgrade是升级所有已安装的包。curl和wget用于下载文件，git是代码版本管理必备，vim是个好用的文本编辑器（如果你习惯nano也可以），net-tools里面包含了一些网络诊断工具如ifconfig。

2.2 ROS Noetic的安装与配置

ROS（Robot Operating System）是我们的核心框架，Ubuntu 20.04对应的ROS版本是Noetic。官方安装步骤其实很清晰，但国内网络访问有时不稳定，我们可以按部就班来。

1. 设置软件源：将ROS官方的软件仓库添加到系统的源列表里。

   sudo sh -c 'echo "deb http://packages.ros.org/ros/ubuntu $(lsb_release -sc) main" > /etc/apt/sources.list.d/ros-latest.list'
   

2. 添加密钥：确保下载的软件包是官方发布的，没有被篡改。

   sudo apt install curl -y
   curl -s https://raw.githubusercontent.com/ros/rosdistro/master/ros.asc | sudo apt-key add -
   

3. 安装ROS：这里我们安装完整桌面版，它包含了ROS、RQT、RViz、Gazebo等一大堆机器人开发常用工具，省得后面再一个个补。

   sudo apt update
   sudo apt install -y ros-noetic-desktop-full
   

   这个过程会下载很多包，根据网速不同，可能需要等待十几分钟到半小时。

4. 环境配置：安装完成后，ROS的命令（如roscore）并不会立即可用，需要让终端“知道”ROS在哪。

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

   第一行命令将ROS的初始化脚本添加到你的用户配置文件（.bashrc）中，这样每次打开新终端都会自动设置好ROS环境。第二行是立即生效。

5. 安装构建工具和依赖管理：为了后续编译我们自己的ROS包，需要安装一些工具。

   sudo apt install -y python3-rosdep python3-rosinstall python3-rosinstall-generator python3-wstool build-essential
   

6. 初始化rosdep：这是一个非常重要的工具，用于安装ROS包的系统依赖。很多安装失败都是因为它没配置好。

   sudo rosdep init
   rosdep update
   

   注意：sudo rosdep init这一步，如果你之前安装过ROS，可能会报错“cannot download default sources list”，这没关系，说明已经初始化过了，直接执行rosdep update即可。rosdep update可能会因为网络问题失败，多试几次，或者可以尝试使用国内镜像源，网上有很多相关教程。

到这里，你的ROS Noetic环境就基本准备好了。可以打开一个新终端，输入roscore，如果看到它开始输出日志信息没有报错，就说明ROS核心启动成功。按Ctrl+C终止它。

3. 搭建通信桥梁：安装与编译MAVROS

MAVROS是什么？你可以把它理解为一个“翻译官”和“邮差”。PX4飞控（无论是真机还是仿真器里的）使用一种叫做MAVLink的通信协议来收发消息。而我们的ROS程序使用的是ROS自己的消息格式（比如geometry_msgs/Twist表示速度指令）。MAVROS的作用就是坐在中间，把ROS消息“翻译”成MAVLink消息发给PX4，也把PX4发来的MAVLink消息“翻译”成ROS消息给我们用。

3.1 创建工作空间与获取源码

ROS的代码通常组织在“工作空间”里。我们来创建一个专用于MAVROS的工作空间。

mkdir -p ~/catkin_ws/src
cd ~/catkin_ws
catkin init
wstool init src

catkin init初始化了一个Catkin构建系统的工作空间。wstool init src则在src目录下初始化了wstool，这是一个管理多个代码仓库的工具。

接下来，我们使用rosinstall_generator来生成一个包含MAVROS及其依赖（主要是MAVLink）的清单文件，然后用wstool根据这个清单去拉取代码。

cd ~/catkin_ws
rosinstall_generator --rosdistro $ROS_DISTRO mavlink | tee /tmp/mavros.rosinstall
rosinstall_generator --upstream mavros | tee -a /tmp/mavros.rosinstall
wstool merge -t src /tmp/mavros.rosinstall
wstool update -t src -j4

关键坑点：wstool update这一步需要从GitHub拉取代码。如果你遇到网络超时、连接失败，这是最常见的问题。解决方法有几个：一是使用稳定的网络连接，有时开手机热点反而更顺畅；二是如果你有加速GitHub访问的方法，可以配置给git；三是可以手动修改src目录下的.rosinstall文件，将其中的GitHub仓库地址替换为国内的镜像源（如Gitee），但要注意版本对应。这里为了流程完整，我们先按标准流程走。

3.2 安装依赖与解决地理库问题

代码拉取完毕后，使用rosdep自动安装所有需要的系统依赖包。这就是之前初始化rosdep的原因。

rosdep install --from-paths src --ignore-src -y

接下来是一个非常重要的步骤：安装GeographicLib数据集。MAVROS需要这个库来进行精确的地理位置计算（比如GPS坐标转换）。如果缺少它，编译虽然能过，但运行时会报错。

cd ~/catkin_ws/src/mavros/mavros/scripts
sudo ./install_geographiclib_datasets.sh

这个脚本会自动下载并安装所需的数据文件。同样，如果下载慢，可以搜索“GeographicLib datasets 国内镜像”寻找替代方案。

3.3 编译与测试

所有准备就绪，开始编译。

cd ~/catkin_ws
catkin build

或者使用传统的catkin_make：

catkin_make -j$(nproc)

-j$(nproc)表示使用你电脑所有的CPU核心并行编译，速度更快。编译过程大概需要5-15分钟，取决于电脑性能。

编译成功后，别忘了刷新当前终端的环境，让系统找到新编译出来的MAVROS包。

source ~/catkin_ws/devel/setup.bash

同样，你也可以把这一行加到~/.bashrc里，方便以后使用。

如何测试MAVROS是否安装成功？ 一个简单的测试方法是查看它提供的节点和话题。先在一个终端运行roscore，然后在另一个终端输入：

rosrun mavros mavros_node

如果这个节点能正常启动并输出一些状态信息（可能需要你提供一些参数，但启动不报错就行），说明MAVROS基本安装成功了。按Ctrl+C停止它。

4. 地面控制站：安装QGroundControl (QGC)

仿真无人机飞起来了，我们得有个“遥控器”和“仪表盘”来看它、控制它，这就是QGroundControl。它是一个功能强大的开源地面站软件，能显示无人机的姿态、位置、电池状态，能规划任务航线，还能进行参数调试。

在Ubuntu上安装QGC非常方便，官方提供了AppImage格式，这是一种打包好的可执行文件，无需安装，直接运行。

1. 下载：访问QGC官网的下载页面，找到适用于Linux的稳定版AppImage文件，下载到你的~/Downloads或任意目录。
2. 赋予执行权限：在终端中，进入你下载文件的目录。

   cd ~/Downloads
   chmod +x ./QGroundControl.AppImage
   

   chmod +x命令给这个文件添加了“可执行”的权限。
3. 运行：直接双击这个文件，或者在终端里输入./QGroundControl.AppImage即可启动。

第一次启动可能会比较慢。界面默认是英文的，你可以在设置（Settings）里找到语言选项，切换为中文。现在先不用管它，等我们的仿真无人机起来之后，再打开QGC，它会自动通过UDP连接上仿真的飞控，非常方便。

5. 核心舞台：编译并启动PX4的Gazebo仿真

这是最激动人心的一步，我们要把PX4飞控的代码和Gazebo仿真环境结合起来。

5.1 获取PX4固件源码

PX4的源码托管在GitHub上。我们使用git来克隆。

cd ~
git clone https://github.com/PX4/PX4-Autopilot.git --recursive

注意：一定要加--recursive参数，因为PX4项目包含了很多子模块（Submodules）。同样，由于仓库很大，克隆过程可能因网络问题中断。如果中断了，可以进入目录cd PX4-Autopilot，然后执行git submodule update --init --recursive来继续更新子模块。

如果网络实在困难，也可以像一些教程里提到的，寻找国内镜像或者通过网盘获取压缩包，但务必注意版本的一致性。

5.2 安装PX4编译与仿真依赖

PX4提供了一个非常方便的脚本，可以一键安装几乎所有需要的依赖。

cd ~/PX4-Autopilot
bash ./Tools/setup/ubuntu.sh

这个脚本会安装编译器、Gazebo、ROS集成包等一大堆东西。它会询问你是否继续，输入Y回车。整个过程耗时较长，请耐心等待。

一个重要的选择：如果你不打算在将来编译真正的飞控硬件（如Pixhawk）的固件，可以在运行脚本时加上--no-nuttx参数，跳过交叉编译工具的安装，能节省不少时间和磁盘空间。

bash ./Tools/setup/ubuntu.sh --no-nuttx

5.3 首次编译与启动仿真

依赖安装完成后，建议重启一下电脑，确保所有环境变量生效。

重启后，我们开始第一次编译针对Gazebo仿真器的PX4固件。

cd ~/PX4-Autopilot
make px4_sitl_default gazebo

这条命令做了几件事：make px4_sitl_default是编译一个用于软件在环（SITL）的默认版本固件；gazebo参数告诉它编译完成后自动启动Gazebo。

这是最可能出错的环节，我遇到过好几次。

• 情况一：编译顺利，Gazebo窗口弹出。恭喜你！你会看到一个带着草坪的空白世界，以及一架小小的四旋翼无人机（通常是Iris或Typhoon模型）。终端里会疯狂滚动PX4和Gazebo的日志。此时，飞控已经启动，但还没解锁。你需要在PX4的终端（就是运行make命令的那个终端）里，按几下回车，调出命令行，输入commander takeoff，无人机就会自动起飞到预设高度。这是成功的标志！

• 情况二：编译失败，提示关于px4_sitl_default的Makefile错误。这是一个常见坑点，特别是之前编译失败过，残留了旧的编译文件。解决方法通常是彻底清理旧的构建目录，然后使用CMake重新配置。

  cd ~/PX4-Autopilot
  rm -rf build/   # 删除旧的构建目录
  make px4_sitl_default gazebo  # 重试
  

  或者，更手动的方式：

  cd ~/PX4-Autopilot
  rm -rf build
  mkdir -p build/px4_sitl_default
  cd build/px4_sitl_default
  cmake ../..
  make -j$(nproc)
  

  编译成功后，再启动Gazebo：

  cd ~/PX4-Autopilot
  source Tools/setup_gazebo.bash $(pwd) $(pwd)/build/px4_sitl_default
  export ROS_PACKAGE_PATH=$ROS_PACKAGE_PATH:$(pwd)
  export ROS_PACKAGE_PATH=$ROS_PACKAGE_PATH:$(pwd)/Tools/sitl_gazebo
  roslaunch px4 posix_sitl.launch
  

  这一串命令设置了Gazebo和PX4交互所需的环境变量，然后用ROS的launch文件启动整个仿真。看到Gazebo界面和终端里PX4启动日志，就成功了。

5.4 连接MAVROS与QGC

现在，我们有了仿真的无人机（PX4 SITL + Gazebo），有了通信桥梁（MAVROS），也有了地面站（QGC）。如何把它们连起来？

1. 启动仿真：确保你的仿真环境正在运行（即Gazebo窗口开着，PX4在终端里跑着）。
2. 启动MAVROS：打开一个新的终端。

   cd ~/catkin_ws
   source devel/setup.bash
   roslaunch mavros px4.launch fcu_url:="udp://:14540@127.0.0.1:14557"
   

   这个命令启动了MAVROS节点，并告诉它：飞控（FCU）的地址（fcu_url）是通过UDP协议，在本机（127.0.0.1）的14557端口上。PX4 SITL默认在这个端口发送数据，而MAVROS在14540端口监听。如果连接成功，你会看到MAVROS终端输出“IMU0: Attitude quaternion”等信息。
3. 启动QGC：双击打开之前下载的QGroundControl。如果一切连接正常，QGC顶部的连接状态指示会从断开变为连接，并且会显示无人机的姿态、电池等信息。

至此，一个完整的PX4无人机仿真开发环境就全部搭建成功了！你可以在Gazebo里观察无人机，可以通过QGC发送起飞、降落、航点任务指令，更可以通过ROS（用rostopic pub或者自己写节点）向/mavros/setpoint_velocity/cmd_vel这类话题发布消息，来控制无人机的运动，开始你的无人机算法开发之旅。

6. 常见问题排坑与效率提升技巧

搭建过程很少有一帆风顺的，这里我汇总几个我踩过和读者问得最多的坑。

网络问题：这是头号敌人。git clone、wstool update、rosdep update、安装脚本下载依赖，每一步都可能因网络超时失败。除了换网络、使用热点，积极利用国内镜像源（如中科大、清华的ROS源，Gitee的代码镜像）是根本解决方案。对于PX4的子模块，可以手动修改.gitmodules文件中的URL。

权限问题：所有需要sudo的操作都要小心。编译和运行ROS节点时，尽量在普通用户下进行，避免权限混乱。如果遇到“Permission denied”，仔细检查文件权限和所属用户。

环境变量冲突：这是最诡异的问题。表现为命令找不到，或者找到的版本不对。务必理解source ~/.bashrc和source devel/setup.bash的作用。原则是：每个新开的终端，如果要用到ROS或自己编译的工作空间，都需要source对应的setup.bash文件。你可以把常用的source命令都加到~/.bashrc末尾一劳永逸。

Gazebo模型下载慢：第一次启动Gazebo，它会下载一些模型（比如地面、天空盒），如果卡住，可以手动下载模型库。网上有打包好的gazebo_models资源，下载后解压放到~/.gazebo/models/目录下。

提升效率：每次测试都要make编译很久？PX4的编译系统支持增量编译，修改代码后再次make通常很快。对于复杂的仿真场景（多机、特殊环境），可以学习使用PX4的make命令参数，例如make px4_sitl_default gazebo_iris_irlock启动带有红外锁定传感器的Iris模型。多看看PX4官方文档，里面有很多宝藏。

最后，记得善用社区。PX4、ROS、Gazebo都有非常活跃的论坛和社区（如PX4 Discourse, ROS Answers, Gazebo Answers）。遇到错误时，把终端里红色的错误信息完整地复制下来去搜索，大概率能找到解决方案。无人机仿真开发是一个充满乐趣的领域，虽然环境搭建有点门槛，但一旦跨过去，后面就是广阔的创意天空。希望这篇详细的指南能帮你顺利起飞