Gazebo 完整指南适配你的 WSL2 Ubuntu22.04 ROS2 Humble ROSMASTER M1 小车先分清关键版本最容易踩大坑两大产品线不兼容插件、模型代码不能混用Gazebo Classic经典版Gazebo 11ROS2 Humble 官方原生配套亚博、Turtlebot3 等绝大多数国内小车教程全部基于这个版本。 命令gazeboGazebo Sim新版曾名 Ignition GazeboHarmonic/Fortress全新重构架构命令gz sim旧小车 URDF/SDF 插件大量不兼容不推荐现在使用✅场景首选Gazebo Classic 11一、WSL2 Ubuntu22.04 Humble 一键安装 Gazebo ClassicROS2 Humble 官方桥接包不需要额外添加 gazebo 源直接 apt 安装bash运行# 核心Gazebo - ROS2通信桥接包必须 sudo apt install -y ros-humble-gazebo-ros-pkgs ros-humble-gazebo-ros2-control # 可选常用控制器差速底盘、舵机、激光雷达仿真必备小车仿真强烈建议装 sudo apt install -y ros-humble-ros2-control ros-humble-ros2-controllers ros-humble-gazebo-ros2-demo二、基础启动测试新开终端先加载 ROS 环境bash运行source /opt/ros/humble/setup.bash # 方式1直接空世界启动gazebo ros2 launch gazebo_ros gazebo.launch.py✅ 正常弹出 Gazebo 仿真窗口 安装成功Gazebo 两大进程概念理解仿真架构gzserver物理仿真引擎计算碰撞、里程计、传感器数据无界面可以后台无头运行gzclient可视化图形窗口仅显示画面关掉不影响仿真运算三、WSL2 高频图形问题【重中之重】Windows11 自带 WSLg理论开箱显示但经常出现黑屏、极其卡顿、无法启动方案 A临时软件渲染立刻解决黑屏牺牲帧率启动 Gazebo 前执行bash运行export LIBGL_ALWAYS_SOFTWARE1 ros2 launch gazebo_ros gazebo.launch.py方案 B永久写入配置推荐bash运行echo export LIBGL_ALWAYS_SOFTWARE1 ~/.bashrc source ~/.bashrc高配显卡想要 WSL GPU 硬件加速需要升级 WSL Mesa 驱动复杂度高调试小车仿真优先使用软件渲染保证稳定。四、与ROSMASTER M1 小车开发结合思路两条开发路线路线 1纯仿真开发电脑 WSL 内编写 M1 小车 URDF 模型底盘、云台舵机、激光雷达 / 相机在 Gazebo 加载模型使用/cmd_vel控制仿真底盘手柄遥控仿真车辆算法调试完成后再下载到真实小车优势不怕撞车、不需要实体硬件快速验证导航 / 避障算法路线 2虚实结合不推荐仿真数据和实体小车互通DDS 网络配置复杂新手优先纯仿真。五、常用基础命令bash运行# 仅启动仿真引擎无头模式无GUI服务器批量仿真用 ros2 launch gazebo_ros gzserver.launch.py # 单独启动图形界面 gzclient # 彻底杀掉所有gazebo进程卡死时救命 killall -9 gzserver gzclient六、国内网络坑Gazebo 模型加载缓慢 / 加载失败首次打开左侧 Insert 模型库需要联网下载官方模型国内经常超时卡住。 解决方法离线模型包bash运行# 创建模型目录 mkdir -p ~/.gazebo/models # 网上下载完整gazebo model库解压放入该目录七、Gazebo 与 Rviz2 区别不要混淆表格工具定位作用Gazebo物理仿真器虚拟世界模拟小车运动、碰撞、虚拟相机 / 雷达生成仿真传感器数据Rviz2可视化工具只展示话题数据真实小车 / Gazebo 仿真输出的数据都能看没有物理仿真能力典型工作流Gazebo虚拟小车发布/cmd_vel、/scan激光数据 → Rviz2 查看机器人状态、雷达点云八、常见报错排查清单gazebo command not found没有 source ROS 环境source /opt/ros/humble/setup.bash窗口黑屏、灰色画面 使用上面LIBGL_ALWAYS_SOFTWARE1开启软件渲染模型加载后小车不受控制 URDF 缺少 gazebo 插件差速驱动插件无法接收/cmd_vel指令Gazebo 启动 CPU 占用 100% WSL 软件渲染常态减少场景物体、关闭多余光源降低负载