- 类别
- 框架与工具 · 部署推理
- 开放程度
- 开源
- 发布时间
- 2014 年
- 开源协议
- Apache-2.0
- 发布方所在地
- 美国
项目简介
第二代机器人操作系统,由开源机器人基金会(Open Robotics)维护,是构建机器人应用的一整套软件库和工具,提供节点间的发布订阅、服务和动作通信,以及驱动、常用算法、构建与调试工具,按发行版定期发布。ros2/ros2 仓库汇总各核心仓库的源码清单,配套 docs.ros.org 文档、ROS 软件包索引和 Docker 镜像,是机器人软件开发中最常用的基础中间件之一。
ROS 2 安装要点
来源:Ubuntu-Install-Debs.rst依据官方资料的 Lyrical Luth 版本整理,核验于 2026-11-06。版本更新后命令可能变化,以官方文档为准。
设置 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启用 Universe 软件源
sudo apt install software-properties-common sudo add-apt-repository universe安装 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更新系统并安装 ROS
{DISTRO} 换成 lyrical 等;无 GUI 用 ros-base
sudo apt update sudo apt upgrade sudo apt install ros-{DISTRO}-desktop加载环境
非 bash 把 .bash 换成 .sh 或 .zsh
source /opt/ros/{DISTRO}/setup.bash运行示例验证
另开终端运行 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.rstROS 2 现行发行版的支持截止时间(Releases 页)和 Tier 1 Ubuntu 版本(各发行版发布页)
| 名称 | Ubuntu 版本 | 支持截止时间 |
|---|---|---|
| Lyrical Luth | 26.04 (Resolute) | 2031 年 5 月 |
| Kilted Kaiju | 24.04 (Noble) | 2026 年 12 月 |
| Jazzy Jalisco | 24.04 (Noble) | 2029 年 5 月 |
| Humble Hawksbill | 22.04 (Jammy) | 2027 年 5 月 |
| Rolling Ridley持续更新的开发发行版,可能含破坏性更新 | — | — |
✓ 官方资料写明支持,— 资料没写,版本号照原文。没写不等于不支持。
常见报错
解法来自官方文档、维护者回复或提问者确认,部分报错出自旧版本。
Unable to create the rendering window after 100 tries原因Wayland 和 RViz2 不兼容
解决用 X11 兼容模式运行 RViz2
来源:Installation-Troubleshooting.rstQT_QPA_PLATFORM=xcb rviz2D3D12: Removing Device.解决WSL2 下运行 RViz 崩溃时,强制它使用软件渲染
来源:Installation-Troubleshooting.rstexport LIBGL_ALWAYS_SOFTWARE=trueThe input line is too long.原因Windows 路径长度限制,目录层级太深时出现
解决注册表把 LongPathsEnabled 设为 1,组策略启用 Enable Win32 long paths,重开终端再构建
来源:Installation-Troubleshooting.rstfile INSTALL cannot set modification time on原因很可能是杀毒软件或 Windows Defender 干扰了构建
解决把工作区路径加入 Windows Defender 的排除列表
来源:Installation-Troubleshooting.rstfailed to create process.原因很可能找不到 Python 解释器
解决确认 Python 位于脚本 shebang(第一行)指定的路径下
来源:Installation-Troubleshooting.rst
获取方式
同类项目
部署推理数据来源
本页信息均整理自以下公开资料。