部署推理开源

ROS 2

Open Robotics美国

GitHub 仓库 ros2/ros2

又称 ROS2、Robot Operating System 2

类别
框架与工具 · 部署推理
开放程度
开源
发布时间
2014 年
开源协议
Apache-2.0
发布方所在地
美国

项目简介

第二代机器人操作系统,由开源机器人基金会(Open Robotics)维护,是构建机器人应用的一整套软件库和工具,提供节点间的发布订阅、服务和动作通信,以及驱动、常用算法、构建与调试工具,按发行版定期发布。ros2/ros2 仓库汇总各核心仓库的源码清单,配套 docs.ros.org 文档、ROS 软件包索引和 Docker 镜像,是机器人软件开发中最常用的基础中间件之一。

ROS 2 安装要点

来源:Ubuntu-Install-Debs.rst

依据官方资料的 Lyrical Luth 版本整理,核验于 2026-11-06。版本更新后命令可能变化,以官方文档为准。

  1. 设置 UTF-8 locale

    sudo apt update && sudo apt install locales
    sudo locale-gen en_US en_US.UTF-8
    sudo update-locale LC_ALL=en_US.UTF-8 LANG=en_US.UTF-8
    export LANG=en_US.UTF-8
  2. 启用 Universe 软件源

    sudo apt install software-properties-common
    sudo add-apt-repository universe
  3. 安装 ros2-apt-source

    这个包负责配置 ROS 的 apt 源和密钥

    sudo apt update && sudo apt install curl -y
    export ROS_APT_SOURCE_VERSION=$(curl -s https://api.github.com/repos/ros-infrastructure/ros-apt-source/releases/latest | grep -F "tag_name" | awk -F'"' '{print $4}')
    curl -L -o /tmp/ros2-apt-source.deb "https://github.com/ros-infrastructure/ros-apt-source/releases/download/${ROS_APT_SOURCE_VERSION}/ros2-apt-source_${ROS_APT_SOURCE_VERSION}.$(. /etc/os-release && echo ${UBUNTU_CODENAME:-${VERSION_CODENAME}})_all.deb"
    sudo dpkg -i /tmp/ros2-apt-source.deb
  4. 更新系统并安装 ROS

    {DISTRO} 换成 lyrical 等;无 GUI 用 ros-base

    sudo apt update
    sudo apt upgrade
    sudo apt install ros-{DISTRO}-desktop
  5. 加载环境

    非 bash 把 .bash 换成 .sh 或 .zsh

    source /opt/ros/{DISTRO}/setup.bash
  6. 运行示例验证

    另开终端运行 demo_nodes_py listener

    source /opt/ros/{DISTRO}/setup.bash
    ros2 run demo_nodes_cpp talker

环境要求

来源:supported-platforms.rst
Ubuntu
26.04 (Resolute),amd64、arm64,Tier 1,可用 deb 包安装
Ubuntu 24.04
Tier 3,需要从源码构建,支持到 2029-06-01
Windows
Windows 11 (VS2022),amd64,Tier 1
RHEL
RHEL 10,amd64,Tier 2
Python
3.12 - 3.14
C++
C++20
Gazebo
Jetty

适配矩阵

来源:Releases.rst

ROS 2 现行发行版的支持截止时间(Releases 页)和 Tier 1 Ubuntu 版本(各发行版发布页)

名称Ubuntu 版本支持截止时间
Lyrical Luth26.04 (Resolute)2031 年 5 月
Kilted Kaiju24.04 (Noble)2026 年 12 月
Jazzy Jalisco24.04 (Noble)2029 年 5 月
Humble Hawksbill22.04 (Jammy)2027 年 5 月
Rolling Ridley持续更新的开发发行版,可能含破坏性更新——

✓ 官方资料写明支持,— 资料没写,版本号照原文。没写不等于不支持。

常见报错

解法来自官方文档、维护者回复或提问者确认,部分报错出自旧版本。

Unable to create the rendering window after 100 tries

原因Wayland 和 RViz2 不兼容

解决用 X11 兼容模式运行 RViz2

QT_QPA_PLATFORM=xcb rviz2
来源:Installation-Troubleshooting.rst
D3D12: Removing Device.

解决WSL2 下运行 RViz 崩溃时,强制它使用软件渲染

export LIBGL_ALWAYS_SOFTWARE=true
来源:Installation-Troubleshooting.rst
The input line is too long.

原因Windows 路径长度限制,目录层级太深时出现

解决注册表把 LongPathsEnabled 设为 1,组策略启用 Enable Win32 long paths,重开终端再构建

来源:Installation-Troubleshooting.rst
file INSTALL cannot set modification time on

原因很可能是杀毒软件或 Windows Defender 干扰了构建

解决把工作区路径加入 Windows Defender 的排除列表

来源:Installation-Troubleshooting.rst
failed to create process.

原因很可能找不到 Python 解释器

解决确认 Python 位于脚本 shebang(第一行)指定的路径下

来源:Installation-Troubleshooting.rst

获取方式

数据来源

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

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

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

ROS 2:安装步骤、环境要求与常见报错 | 具身集