保姆级教程：在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/null1.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 ~/.bashrc2. 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-install2.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 ~/.bashrc2.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_map3.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中：
- 点击"2D Pose Estimate"初始化机器人位置
- 点击"Navigation2 Goal"设置目标点
4. 高级功能与故障排除
4.1 多环境仿真切换
TurtleBot3支持多种预设环境：
| 环境名称 | 启动命令 | 特点描述 |
|---|---|---|
| 空世界 | empty_world.launch.py | 干净环境，适合基础测试 |
| 迷宫世界 | turtlebot3_world.launch.py | 标准测试环境 |
| 房屋场景 | turtlebot3_house.launch.py | 复杂室内环境 |
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>
