Ubuntu22.04搭建ROS2 Humble+Gazebo仿真环境指南（2026年最新详细保姆级教程）

一、环境准备与系统更新

在开始安装任何软件之前，确保你的 Ubuntu22.04 系统处于最新状态，并且配置了正确的语言环境，这可以避免后续编译过程中出现奇怪的错误 -8。

sudo apt update && sudo apt upgrade -y# 确保有curl工具sudo apt install curl -y# 设置语言环境为UTF-8sudo apt install localessudo locale-gen en_US en_US.UTF-8sudo update-locale LC_ALL=en_US.UTF-8 LANG=en_US.UTF-8export LANG=en_US.UTF-8

二、安装ROS2 Humble全攻略

ROS2 Humble Hawksbill 是 Ubuntu22.04 的官方推荐版本，也是一个长期支持版本（LTS），稳定性非常有保障 -8。我们将安装桌面版（Desktop），它包含了 RViz2、常用库和示例程序。

1. 添加ROS2软件源

首先，需要允许 Ubuntu 使用 universe 存储库，并添加 ROS2 的 GPG 密钥和官方源 -1-6。

sudo apt install software-properties-commonsudo add-apt-repository universe# 添加ROS2的GPG密钥sudo curl -sSL https://raw.githubusercontent.com/ros/rosdistro/master/ros.key -o /usr/share/keyrings/ros-archive-keyring.gpg# 添加ROS2源列表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

2. 安装ROS2 Humble

更新软件包索引后，即可开始安装。

sudo apt updatesudo apt install ros-humble-desktopsudo apt install ros-dev-tools

3. 设置环境变量

为了每次打开终端都能自动加载 ROS2 环境，需要将 source 命令写入 .bashrc 文件中 -5-10。

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

4. 验证安装（小乌龟测试）

打开一个新的终端，运行海龟仿真器：ros2 run turtlesim turtlesim_node。再打开另一个终端，运行键盘控制节点：ros2 run turtlesim turtle_teleop_key。如果你能用键盘控制屏幕上的小乌龟移动，那么恭喜你，机器人操作系统的核心部分已经安装成功了 -1。

三、安装Gazebo仿真器

不同于ROS1，在ROS2 Humble环境下，Gazebo需要单独安装。这里我们安装的是 Gazebo Classic，也就是我们常说的 Gazebo仿真 平台 -3。

1. 安装Gazebo核心库

sudo apt updatesudo apt install gazebo

2. 安装ROS2与Gazebo的接口包

为了让 ROS2 能够控制 Gazebo 中的模型，以及进行数据通信，必须安装这些桥接包 -5-9。

sudo apt install ros-humble-gazebo-ros-pkgs ros-humble-gazebo-ros2-control

3. 验证Gazebo安装

直接在终端输入 gazebo 或者 ign gazebo，如果能正常打开图形界面且不报错，即表示安装成功 -4。

四、联合仿真测试与工作空间配置

环境都安装好后，我们来创建一个测试工作空间，启动一个联合仿真示例，验证 ROS2 Humble安装 和 Gazebo 是否能协同工作。

1. 创建工作空间

我们将创建一个名为 sim_ws 的工作空间，并下载一个简单的机器人模型描述文件进行测试。

mkdir -p ~/sim_ws/srccd ~/sim_ws/src# 克隆一个包含差分驱动机器人的示例包 (或者使用你喜欢的任何简单包)git clone https://github.com/ros-simulation/gazebo_ros_demos.git -b humblecd ~/sim_ws# 安装依赖sudo apt install python3-rosdepsudo rosdep initrosdep updaterosdep install --from-paths src --ignore-src -r -y# 编译工作空间colcon build --symlink-installecho "source ~/sim_ws/install/setup.bash" >> ~/.bashrcsource ~/.bashrc

2. 启动仿真世界

现在，让我们在一个空的仿真环境中放入一个差速驱动小车模型。

# 启动Gazebo，加载一个空世界ros2 launch gazebo_ros empty_world.launch.py# 保持刚才的终端运行，打开一个新的终端，生成一个机器人模型ros2 run gazebo_ros spawn_entity.py -entity rrbot -file $(ros2 pkg prefix gazebo_ros_demos)/share/gazebo_ros_demos/models/rrbot/model.sdf

如果一切顺利，你应该在打开的 Gazebo 窗口中看到一个红色的双关节机械臂模型（rrbot）。这表明你的整个 Ubuntu22.04教程 所搭建的仿真链路是完全通畅的。

五、常见问题与排错

• 问题： Gazebo 启动非常慢或者卡在黑色界面。解决： 第一次启动 Gazebo 需要下载很多模型文件，这是正常现象。可以手动下载模型库到 ~/.gazebo/models/ 目录下加速 -3。或者检查网络连接。
• 问题： 运行 ros2 命令提示找不到包。解决： 确认是否正确 source 了 setup.bash 文件。执行 echo $ROS_DISTRO 查看当前环境是否是 humble。
• 问题： 编译工作空间时报错 "Could not find a package configuration file"。解决： 使用 rosdep install 检查并安装所有缺失的依赖 -2-7。

至此，你已经成功在 Ubuntu22.04 上搭建起了 ROS2 Humble 和 Gazebo 的联合仿真环境。这只是一个开始，接下来你可以探索如何用 ROS2 控制你的虚拟机器人，进行 SLAM 建图或导航算法仿真了。祝你探索愉快！

关键词: ROS2 Humble安装, Gazebo仿真, Ubuntu22.04教程, 机器人操作系统