保姆级教程：在Ubuntu 22.04上用ROS2 Humble和Gazebo搞定TurtleBot3仿真（从安装到建图导航）

保姆级教程：在Ubuntu 22.04上用ROS2 Humble和Gazebo搞定TurtleBot3仿真（从安装到建图导航）

机器人操作系统（ROS）正在重塑现代机器人开发流程。作为ROS2的最新长期支持版本，Humble Hawksbill为开发者带来了更稳定的API和更完善的工具链。本教程将带您从零开始，在Ubuntu 22.04系统上搭建完整的TurtleBot3仿真环境，涵盖从基础安装到高级导航的全流程。无论您是 robotics 新手还是希望迁移到ROS2的开发者，这份手把手指南都能帮助您避开常见陷阱，快速构建可工作的仿真系统。

1. 环境准备与ROS2安装

1.1 系统基础配置

在开始ROS2安装前，建议先执行以下系统更新和依赖安装：

sudo apt update && sudo apt upgrade -y sudo apt install curl gnupg2 lsb-release -y

注意：所有命令建议逐行执行，避免复制多行导致权限问题。

设置ROS2软件源密钥：

sudo curl -sSL https://raw.githubusercontent.com/ros/rosdistro/master/ros.key -o /usr/share/keyrings/ros-archive-keyring.gpg echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/ros-archive-keyring.gpg] http://packages.ros.org/ros2/ubuntu $(lsb_release -cs) main" | sudo tee /etc/apt/sources.list.d/ros2.list > /dev/null

1.2 ROS2 Humble核心安装

安装桌面完整版ROS2（包含GUI工具和常用软件包）：

sudo apt update sudo apt install ros-humble-desktop -y

验证安装是否成功：

source /opt/ros/humble/setup.bash ros2 run demo_nodes_cpp talker

预期看到终端持续输出"Publishing: 'Hello World'"消息

1.3 开发工具链配置

安装colcon构建工具和常用扩展：

sudo apt install python3-colcon-common-extensions python3-rosdep2 -y sudo rosdep init rosdep update

配置环境变量永久生效：

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

2. TurtleBot3仿真环境搭建

2.1 TurtleBot3软件包安装

创建工作空间并下载源码：

mkdir -p ~/tb3_ws/src cd ~/tb3_ws wget https://raw.githubusercontent.com/ROBOTIS-GIT/turtlebot3/humble-devel/turtlebot3.repos vcs import src < turtlebot3.repos

解决常见依赖问题：

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

编译源码（约需10-15分钟）：

colcon build --symlink-install

2.2 Gazebo模型配置

加速Gazebo模型下载：

cd ~/.gazebo/ git clone https://github.com/osrf/gazebo_models models --depth=1 rm -rf models/.git

设置TurtleBot3模型环境变量：

echo 'export GAZEBO_MODEL_PATH=$GAZEBO_MODEL_PATH:~/tb3_ws/src/turtlebot3/turtlebot3_simulations/turtlebot3_gazebo/models' >> ~/.bashrc echo 'export TURTLEBOT3_MODEL=burger' >> ~/.bashrc source ~/.bashrc

2.3 验证仿真环境

启动空世界测试：

ros2 launch turtlebot3_gazebo empty_world.launch.py

预期看到Gazebo界面和TurtleBot3 burger模型

键盘控制测试：

ros2 run turtlebot3_teleop teleop_keyboard

使用WASD键控制机器人移动，观察Gazebo中的响应

3. 建图与导航系统配置

3.1 使用Cartographer构建地图

启动带障碍物的仿真世界：

ros2 launch turtlebot3_gazebo turtlebot3_world.launch.py

新终端启动建图节点：

ros2 launch turtlebot3_cartographer cartographer.launch.py use_sim_time:=true

控制机器人探索环境：

ros2 run turtlebot3_teleop teleop_keyboard

保存生成的地图：

ros2 run nav2_map_server map_saver_cli -f ~/tb3_map

3.2 导航系统部署

修改导航参数配置：

nano ~/tb3_ws/src/turtlebot3/turtlebot3_navigation2/param/burger.yaml

将robot_model_type修改为：

robot_model_type: "nav2_amcl::DifferentialMotionModel"

启动导航系统：

ros2 launch turtlebot3_navigation2 navigation2.launch.py use_sim_time:=true map:=~/tb3_map.yaml

在RViz2中：

1. 点击"2D Pose Estimate"初始化机器人位置
2. 点击"Navigation2 Goal"设置目标点

4. 高级功能与故障排除

4.1 多环境仿真切换

TurtleBot3支持多种预设环境：

4.2 常见错误解决方案

问题1：Gazebo模型加载缓慢

export GZ_SIM_RESOURCE_PATH=~/tb3_ws/src/turtlebot3/turtlebot3_simulations/turtlebot3_gazebo/models

问题2：RViz2无法显示机器人模型检查URDF配置：

ros2 run turtlebot3_bringup turtlebot3_description.py

问题3：导航时地图不显示确保burger.yaml中配置正确：

robot_model_type: "nav2_amcl::DifferentialMotionModel"

4.3 性能优化技巧

• 使用--ros-args --log-level WARN减少终端输出
• Gazebo运行时添加-s参数禁用GUI：

  gazebo -s libgazebo_ros_init.so

• 对于低配机器，可以降低仿真精度：

  <physics type="ode"> <max_step_size>0.01</max_step_size> <real_time_factor>1.0</real_time_factor> </physics>