保姆级教程：在Ubuntu 22.04上用ROS2 Humble和Gazebo搞定TurtleBot3仿真（附避坑点）
从零搭建TurtleBot3仿真环境：Ubuntu 22.04 + ROS2 Humble全流程指南
第一次接触机器人仿真时，那种看着虚拟机器人在屏幕上动起来的兴奋感至今难忘。但随之而来的依赖报错、环境配置冲突和莫名其妙的启动失败，也让我在入门阶段踩了不少坑。本文将带你用最稳妥的方式，在Ubuntu 22.04上完成ROS2 Humble和TurtleBot3的仿真环境搭建，每个步骤都经过实测验证，特别标注了新手容易踩坑的环节。
1. 系统准备与环境配置
1.1 Ubuntu 22.04基础设置
开始前请确保系统已更新至最新状态。打开终端执行：
sudo apt update && sudo apt upgrade -y必装工具链（缺少这些会导致后续步骤失败）：
sudo apt install -y curl git python3-pip build-essential设置时区避免后续时间戳问题：
sudo timedatectl set-timezone Asia/Shanghai提示：所有命令建议逐条执行，不要一次性粘贴多行命令，便于定位出错点
1.2 配置ROS2 Humble源
官方推荐使用UTF-8编码环境，先检查语言设置：
locale # 确认LANG=en_US.UTF-8添加ROS2仓库和密钥：
sudo apt install -y software-properties-common sudo add-apt-repository universe 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 $(. /etc/os-release && echo $UBUNTU_CODENAME) main" | sudo tee /etc/apt/sources.list.d/ros2.list > /dev/null安装完整版ROS2（约15分钟）：
sudo apt update && sudo apt install -y ros-humble-desktop2. TurtleBot3环境部署
2.1 创建工作空间
建议使用独立工作空间管理仿真环境：
mkdir -p ~/tb3_ws/src cd ~/tb3_ws/src git clone -b humble-devel https://github.com/ROBOTIS-GIT/turtlebot3_simulations.git安装依赖项（关键步骤）：
sudo apt install -y ros-humble-gazebo-ros-pkgs ros-humble-cartographer ros-humble-cartographer-ros2.2 编译与环境变量设置
编译前需指定TurtleBot3型号（默认burger）：
echo "export TURTLEBOT3_MODEL=burger" >> ~/.bashrc source ~/.bashrc开始编译：
cd ~/tb3_ws colcon build --symlink-install常见错误：若编译报错缺少依赖，尝试
rosdep install --from-paths src --ignore-src -r -y
3. Gazebo仿真启动与验证
3.1 基础世界测试
启动空地图测试：
source ~/tb3_ws/install/setup.bash ros2 launch turtlebot3_gazebo empty_world.launch.py正常启动后应看到Gazebo界面和机器人模型。如果卡在加载界面：
- 检查显卡驱动：
nvidia-smi - 尝试软件渲染模式：
export LIBGL_ALWAYS_SOFTWARE=1
3.2 多环境切换
TurtleBot3提供多种预设环境，文件位于：
~/tb3_ws/src/turtlebot3_simulations/turtlebot3_gazebo/worlds/启动房屋环境示例：
ros2 launch turtlebot3_gazebo turtlebot3_house.launch.py4. 机器人控制实战
4.1 键盘遥控操作
新终端中启动键盘控制：
source ~/tb3_ws/install/setup.bash ros2 run turtlebot3_teleop teleop_keyboard控制键位说明：
| 按键 | 功能 |
|---|---|
| W | 前进 |
| S | 后退 |
| A | 左转 |
| D | 右转 |
| 空格 | 急停 |
| Q | 退出 |
4.2 自动避障演示
启动自主导航节点：
ros2 run turtlebot3_gazebo turtlebot3_drive该节点会实现以下功能：
- 通过激光雷达检测障碍物
- 自动规划避障路径
- 发布速度指令到
/cmd_vel话题
5. 进阶调试技巧
5.1 可视化工具推荐
- RQT：综合图形化工具
rqt - RViz2：传感器数据可视化
ros2 run rviz2 rviz2
5.2 常见问题解决
Gazebo黑屏问题：
echo "export SVGA_VGPU10=0" >> ~/.bashrc source ~/.bashrcROS2节点通信异常： 检查网络配置：
export ROS_DOMAIN_ID=<唯一数字>激光雷达无数据： 检查Gazebo插件配置：
<plugin name="gazebo_ros_ray_sensor" filename="libgazebo_ros_ray_sensor.so"/>