- 类别
- 仿真与评测 · 仿真器
- 开放程度
- 开源
- 发布时间
- 2004 年
- 开源协议
- Apache-2.0
- 发布方所在地
- 美国
项目简介
开源机器人仿真器,新版 Gazebo Sim(曾名 Ignition Gazebo)由 Gazebo Classic 演进而来。可接入多种物理引擎,用 OGRE 2 等引擎渲染,提供激光雷达、相机、接触、力 / 力矩、IMU、GPS 等传感器及噪声模型,支持插件、图形界面和远程消息通信。ros_gz 提供与 ROS / ROS 2 的桥接。旧版 Classic 已于 2025-01 停止维护。
Gazebo 安装要点
来源:gazebosim.org依据官方资料的 gz-sim10_10.0.0 版本整理,核验于 2026-11-06。版本更新后命令可能变化,以官方文档为准。
安装必要工具
ROS 用户先看官方 ROS/Gazebo 安装说明
sudo apt-get update sudo apt-get install curl lsb-release gnupg添加 OSRF 软件源
Jetty 二进制包提供给 Ubuntu 24.04 和 26.04
sudo curl https://packages.osrfoundation.org/gazebo.gpg --output /usr/share/keyrings/pkgs-osrf-archive-keyring.gpg echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/pkgs-osrf-archive-keyring.gpg] https://packages.osrfoundation.org/gazebo/ubuntu-stable $(lsb_release -cs) main" | sudo tee /etc/apt/sources.list.d/gazebo-stable.list > /dev/null安装 Gazebo Jetty
ROS 用户装 ros-${ROS_DISTRO}-ros-gz 即可
sudo apt-get update sudo apt-get install gz-jetty启动 Gazebo Sim来源:gazebosim.org
macOS 要开两个终端,分别运行服务端和 GUI
gz sim shapes.sdf
环境要求
来源:gazebosim.org- Ubuntu 26.04
- Jetty(官方推荐,ROS 2 Lyrical 也用它)或 Rotary(ROS 2 Rolling)
- Ubuntu 24.04
- Jetty(官方推荐)、Harmonic(ROS 2 Jazzy)、Ionic(ROS 2 Kilted)
- Ubuntu 22.04
- Harmonic(官方推荐)、Fortress(ROS 2 Humble)
- macOS
- Sequoia arm64(到 2027 年 8 月):Jetty(官方推荐)、Ionic、Harmonic、Fortress
- Windows
- 通过 conda-forge 和 Pixi 实验性支持 Jetty,有已知运行问题
适配矩阵
来源:gazebosim.orgROS 2 与 Gazebo 版本的兼容情况,yes 是官方推荐组合,partial 是可行但要花功夫
| 名称 | Fortress | Harmonic | Ionic | Jetty | Rotary |
|---|---|---|---|---|---|
| ROS 2 Lyrical(LTS) | 不支持 | 部分 | 部分 | ✓ | — |
| ROS 2 Kilted | 不支持 | 部分 | ✓ | 不支持 | — |
| ROS 2 Jazzy(LTS) | 不支持 | ✓ | 不支持 | 不支持 | — |
| ROS 2 Humble(LTS) | ✓ | 部分 | 不支持 | 不支持 | — |
| ROS 2 Rolling | — | — | — | — | ✓ |
✓ 官方资料写明支持,— 资料没写。没写不等于不支持。
常见报错
解法来自官方文档、维护者回复或提问者确认,部分报错出自旧版本。
I cannot find any available 'gz' command:原因找不到 Gazebo 库
解决把 GZ_CONFIG_PATH 设成安装目录下的 share/gz/
来源:gazebosim.orgGZ_CONFIG_PATH=<path_to_install_dir>/share/gz/OGRE EXCEPTION(3:RenderingAPIException): OpenGL 3.3 is not supported. Please update your graphics card drivers.原因Ogre 2 要 OpenGL 3.3 以上,官方建议 4.3+
解决更新显卡驱动;虚拟机里可试软件渲染,或用 --render-engine ogre 改用 Ogre 1
来源:gazebosim.orgexport LIBGL_ALWAYS_SOFTWARE=1Unable to create the rendering window: OGRE EXCEPTION(3:RenderingAPIException): currentGLContext was specified with no current GL context原因Ogre 和 Qt 在 Wayland 下的交互问题
解决把 Qt 平台设成 xcb;或取消 WAYLAND_DISPLAY,用 XWayland 启动
来源:gazebosim.orgQT_QPA_PLATFORM=xcb gz sim -v 4 shapes.sdfGUI requesting list of world names. The server may be busy downloading resources. Please be patient.原因网络配置不当,窗口打开后没有响应
解决按 ROS Enable Multicast 的步骤开启组播
来源:gazebosim.orgError: The maximum number of open files on this system has been reached.原因macOS 默认打开文件数上限 256 太低
解决调大 ulimit 后继续 homebrew 安装
来源:gazebosim.orgulimit -n 10240libEGL warning: DRI2: failed to create dri screen原因Ogre 2 初始化时枚举设备查询 EGL 支持打印的警告
解决可以忽略,Gazebo 能继续正常运行
来源:gazebosim.org
适配机器人
- PR2
- Pioneer2 DX
- iRobot Create
- TurtleBot