保姆级教程：在Ubuntu 22.04上从零搭建ROS2 Humble的TurtleBot3仿真环境（含Gazebo和Navigation2）
保姆级教程：在Ubuntu 22.04上从零搭建ROS2 Humble的TurtleBot3仿真环境（含Gazebo和Navigation2）
如果你刚接触ROS2机器人开发，想要快速搭建一个完整的仿真环境来学习导航算法，那么这份手把手教程就是为你准备的。我们将从零开始，在Ubuntu 22.04系统上配置ROS2 Humble环境，安装Gazebo物理仿真器，导入TurtleBot3机器人模型，并最终运行Navigation2导航栈实现自主路径规划。整个过程会详细解释每个步骤的原理，并标注可能遇到的"坑"和解决方案。
1. 系统准备与环境配置
在开始之前，确保你的系统满足以下基本要求：
- 操作系统：Ubuntu 22.04 LTS（推荐纯净安装）
- 硬件配置：至少4GB内存，20GB可用磁盘空间
- 网络连接：稳定的互联网连接以下载软件包
首先更新系统软件包并安装一些基础依赖：
sudo apt update && sudo apt upgrade -y sudo apt install curl gnupg2 lsb-release -y为ROS2 Humble添加官方软件源：
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 $(source /etc/os-release && echo $UBUNTU_CODENAME) main" | sudo tee /etc/apt/sources.list.d/ros2.list > /dev/null2. ROS2 Humble完整安装
ROS2 Humble Hawksbill是当前推荐的LTS（长期支持）版本，特别适合学习和生产环境使用。执行以下命令进行完整安装：
sudo apt update sudo apt install ros-humble-desktop -y安装完成后，设置环境变量以便在终端中使用ROS2命令：
source /opt/ros/humble/setup.bash echo "source /opt/ros/humble/setup.bash" >> ~/.bashrc验证安装是否成功：
ros2 run demo_nodes_cpp talker在另一个终端中运行：
ros2 run demo_nodes_py listener如果能看到talker发送的消息被listener接收并打印，说明ROS2核心功能安装正确。
3. Gazebo仿真环境配置
Gazebo是ROS生态中最常用的物理仿真器，我们将安装与ROS2 Humble兼容的版本：
sudo apt install ros-humble-gazebo-ros-pkgs -y测试Gazebo是否能正常运行：
ros2 launch gazebo_ros gazebo.launch.py这个命令会启动一个空的Gazebo世界。如果看到3D仿真界面出现，说明安装成功。
注意：首次启动Gazebo可能会下载模型资源，这可能需要一些时间。所有模型下载完成后会存储在~/.gazebo/models目录下。
4. TurtleBot3仿真模型安装
TurtleBot3是ROS官方推荐的入门级移动机器人平台，非常适合学习和算法验证。安装其仿真包：
sudo apt install ros-humble-turtlebot3* -y设置默认机器人模型（这里选择waffle_pi型号）：
echo "export TURTLEBOT3_MODEL=waffle_pi" >> ~/.bashrc source ~/.bashrc验证TurtleBot3模型能否正确加载：
ros2 launch turtlebot3_gazebo turtlebot3_world.launch.py这个命令会启动一个包含TurtleBot3的Gazebo世界。你应该能看到一个类似汉堡形状的机器人在一个简单的室内环境中。
5. Navigation2导航栈安装与配置
Navigation2是ROS2中的标准导航系统，实现了地图构建、定位、路径规划等核心功能。安装Navigation2及相关组件：
sudo apt install ros-humble-navigation2 ros-humble-nav2-bringup ros-humble-cartographer ros-humble-cartographer-ros -y创建一个工作空间用于存放导航配置：
mkdir -p ~/nav2_ws/src cd ~/nav2_ws colcon build配置环境变量使Navigation2能够找到TurtleBot3的配置文件：
echo "export GAZEBO_MODEL_PATH=$GAZEBO_MODEL_PATH:/opt/ros/humble/share/turtlebot3_gazebo/models" >> ~/.bashrc source ~/.bashrc6. 运行完整仿真导航系统
现在我们可以启动完整的仿真系统了。首先在一个终端中启动Gazebo世界和TurtleBot3：
ros2 launch turtlebot3_gazebo turtlebot3_world.launch.py在另一个终端中启动Navigation2：
ros2 launch nav2_bringup tb3_simulation_launch.py这会打开RViz可视化界面。在RViz中，你可以：
- 使用"2D Pose Estimate"按钮在地图上标记机器人的初始位置
- 使用"Nav2 Goal"按钮设置导航目标点
- 观察机器人规划的路径和实际运动轨迹
7. 常见问题与解决方案
在实际操作中，你可能会遇到以下典型问题：
问题1：Gazebo启动后黑屏或卡住
解决方案：
- 检查显卡驱动是否安装正确
- 尝试以简化模式启动：
ros2 launch gazebo_ros gazebo.launch.py verbose:=true
问题2：TurtleBot3模型无法加载
解决方案：
- 确认TURTLEBOT3_MODEL环境变量设置正确
- 检查GAZEBO_MODEL_PATH是否包含TurtleBot3模型路径
问题3：Navigation2无法正确规划路径
解决方案：
- 确保机器人初始位置估计准确
- 检查地图是否有障碍物阻挡
- 调整costmap参数以优化路径规划
8. 进阶配置与自定义
一旦基础环境运行正常，你可以尝试以下进阶操作：
- 修改机器人参数：编辑
/opt/ros/humble/share/turtlebot3_gazebo/models/turtlebot3_waffle_pi/model.sdf文件调整物理特性 - 创建自定义地图：使用SLAM Toolbox构建自己的环境地图
- 添加传感器：在Gazebo中为机器人添加激光雷达或深度相机
- 开发导航算法：基于Nav2的插件接口实现自定义路径规划器
# 示例：启动SLAM建图 ros2 launch turtlebot3_cartographer cartographer.launch.py use_sim_time:=true通过这个完整的教程，你应该已经建立了一个功能完善的ROS2机器人仿真环境。这个环境不仅适用于学习导航算法基础，也可以作为更复杂机器人应用的开发平台。