从零到一：基于ROS2与TurtleBot3的室内自主建图与导航全流程实战

1. 环境准备：搭建ROS2与TurtleBot3开发环境

第一次接触ROS2和TurtleBot3时，我花了两天时间才把环境搭好。现在回想起来，其实只要按照正确的顺序操作，半小时就能搞定。我们先从最基础的ROS2 Humble安装开始，这是目前最稳定的LTS版本。

安装ROS2 Humble最简单的方式是使用官方提供的二进制包。打开终端，依次执行以下命令：

sudo apt update && sudo apt install curl gnupg lsb-release 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/null sudo apt update sudo apt install ros-humble-desktop

安装完成后，记得在~/.bashrc文件末尾添加环境变量设置：

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

接下来安装Gazebo仿真环境。这里有个小技巧：如果你只做TurtleBot3仿真，可以只安装必要的Gazebo组件，节省磁盘空间：

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

我建议先测试Gazebo是否能正常运行。执行gazebo命令后，你应该能看到一个空的世界界面。如果遇到黑屏或者卡住的情况，很可能是显卡驱动问题。NVIDIA显卡用户需要安装专有驱动，Intel核显用户可以尝试添加LIBGL_ALWAYS_SOFTWARE=1环境变量。

2. 安装关键功能包：Cartographer与Nav2

Cartographer是Google开源的SLAM算法，在室内建图方面表现非常出色。安装时要注意版本匹配问题：

sudo apt install ros-humble-cartographer ros-humble-cartographer-ros

Nav2是ROS2的导航框架，相当于ROS1中的move_base。安装命令如下：

sudo apt install ros-humble-navigation2 ros-humble-nav2-bringup ros-humble-nav2-common

TurtleBot3的安装有个容易踩的坑：不同型号（Burger/Waffle/Waffle Pi）需要不同的功能包。我建议全部安装，使用时通过环境变量切换：

sudo apt install ros-humble-turtlebot3*

安装完成后，必须设置TURTLEBOT3_MODEL环境变量。我习惯把它加到~/.bashrc里：

echo "export TURTLEBOT3_MODEL=waffle" >> ~/.bashrc source ~/.bashrc

键盘控制包虽然不是必须的，但对于调试非常有用：

sudo apt install ros-humble-teleop-twist-keyboard

3. 室内建图实战：从启动到保存

现在进入最激动人心的部分——实际建图操作。首先启动Gazebo仿真环境：

ros2 launch turtlebot3_gazebo turtlebot3_house.launch.py

第一次启动可能会比较慢，因为要加载房屋模型。如果Gazebo窗口黑屏，可以尝试调整渲染引擎：

export LIBGL_ALWAYS_SOFTWARE=1 ros2 launch turtlebot3_gazebo turtlebot3_house.launch.py

新建一个终端，启动Cartographer节点：

ros2 launch turtlebot3_cartographer cartographer.launch.py

再开一个终端，启动键盘控制：

ros2 run teleop_twist_keyboard teleop_twist_keyboard

控制机器人移动时要注意：建图质量与移动速度直接相关。建议保持低速（0.2m/s以下），在转角处更慢。我通常按以下顺序探索环境：

1. 先沿墙壁走一圈
2. 然后以"之"字形路线覆盖开放区域
3. 最后重点扫描容易遗漏的角落

建图完成后，保存地图：

ros2 run nav2_map_server map_saver_cli -f ~/map/my_map

保存的地图包含两个文件：my_map.pgm（图像数据）和my_map.yaml（元数据）。建议定期备份这些文件，我遇到过好几次建图到一半系统崩溃的情况。

4. 自主导航实现与调试技巧

有了地图后，我们就可以实现自主导航了。首先启动Gazebo仿真：

ros2 launch turtlebot3_gazebo turtlebot3_house.launch.py

然后启动Nav2导航系统，注意要指定地图路径和使用仿真时间：

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

打开RViz界面进行导航测试：

ros2 run rviz2 rviz2 -d $(ros2 pkg prefix turtlebot3_navigation2)/share/turtlebot3_navigation2/rviz/turtlebot3_navigation2.rviz

在RViz中操作时有两个关键步骤：

1. 使用"2D Pose Estimate"工具设置初始位置（点击地图上的大致位置并拖动确定朝向）
2. 使用"Nav2 Goal"工具设置目标位置

我遇到过机器人定位丢失的问题，通常是因为初始位置设置不准确。解决方法：

1. 确保初始位置设置在机器人实际位置附近
2. 可以多次发送初始位姿帮助AMCL收敛
3. 在RViz中观察粒子云是否集中在机器人周围

另一个常见问题是路径规划失败。检查以下参数：

1. 在nav2_params.yaml中调整planner_server的步长和迭代次数
2. 确保costmap的inflation_radius设置合理（我一般用0.3）
3. 检查地图是否有未探索的未知区域

5. 常见问题排查与性能优化

在实际项目中，我总结了一些典型问题的解决方法：

Gazebo相关问题：

• 如果Gazebo启动时报模型找不到错误，设置模型路径：

  export GAZEBO_MODEL_PATH=$GAZEBO_MODEL_PATH:/opt/ros/humble/share/turtlebot3_gazebo/models

• 遇到"gzserver已存在"错误时：

  killall gzserver

Cartographer调优：在建图过程中，可以通过修改cartographer.launch.py中的参数优化性能：

1. 提高num_laser_scans和num_multi_echo_laser_scans可以改善建图精度
2. 调整MAP_BUILDER.num_subdivisions_to_finalize可以平衡建图质量和速度
3. 对于大型环境，增加TRAJECTORY_BUILDER_2D.submaps.num_range_data

Nav2性能优化：在nav2_params.yaml中，我通常会调整这些参数：

1. controller_server的max_speed_xy和max_accel_xy
2. planner_server的tolerance和max_iterations
3. behavior_tree的恢复机制超时时间

内存管理：长时间运行Gazebo和Cartographer会消耗大量内存。建议：

1. 定期重启节点
2. 使用ros2 topic hz监控话题频率
3. 关闭不必要的可视化工具

经过多次实践，我发现TurtleBot3 Waffle模型在仿真中表现最稳定。如果你遇到奇怪的物理碰撞问题，可以尝试切换模型：

export TURTLEBOT3_MODEL=waffle