仿真器开源

Gazebo

Open Robotics、Intrinsic美国

GitHub 仓库 gazebosim/gz-sim

又称 Gazebo Sim、Ignition Gazebo、Gazebo Classic、gz-sim、ros_gz

类别
仿真与评测 · 仿真器
开放程度
开源
发布时间
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。版本更新后命令可能变化,以官方文档为准。

  1. 安装必要工具

    ROS 用户先看官方 ROS/Gazebo 安装说明

    sudo apt-get update
    sudo apt-get install curl lsb-release gnupg
  2. 添加 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
  3. 安装 Gazebo Jetty

    ROS 用户装 ros-${ROS_DISTRO}-ros-gz 即可

    sudo apt-get update
    sudo apt-get install gz-jetty
  4. 启动 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.org

ROS 2 与 Gazebo 版本的兼容情况,yes 是官方推荐组合,partial 是可行但要花功夫

名称FortressHarmonicIonicJettyRotary
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/

GZ_CONFIG_PATH=<path_to_install_dir>/share/gz/
来源:gazebosim.org
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

export LIBGL_ALWAYS_SOFTWARE=1
来源:gazebosim.org
Unable 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 启动

QT_QPA_PLATFORM=xcb gz sim -v 4 shapes.sdf
来源:gazebosim.org
GUI requesting list of world names. The server may be busy downloading resources. Please be patient.

原因网络配置不当,窗口打开后没有响应

解决按 ROS Enable Multicast 的步骤开启组播

来源:gazebosim.org
Error: The maximum number of open files on this system has been reached.

原因macOS 默认打开文件数上限 256 太低

解决调大 ulimit 后继续 homebrew 安装

ulimit -n 10240
来源:gazebosim.org
libEGL warning: DRI2: failed to create dri screen

原因Ogre 2 初始化时枚举设备查询 EGL 支持打印的警告

解决可以忽略,Gazebo 能继续正常运行

来源:gazebosim.org

适配机器人

  • PR2
  • Pioneer2 DX
  • iRobot Create
  • TurtleBot

获取方式

相关概念

数据来源

本页信息均整理自以下公开资料。

7 条来源核验于 2026-10-01

星标、下载量等指标定期自动更新。

Gazebo(gz-sim):安装步骤、环境要求与常见报错 | 具身集