Ubuntu24.04安装ROS2

ROS2 官方其实提供了完整的安装文档，但国内网络环境下照着抄，最常见的卡点是添加 GPG 密钥时连接超时。本文按 Ubuntu 24.04 的实际操作顺序整理一遍：确认系统版本、选对应 ROS2 版本、设语言环境、加密钥、加源、装开发工具和桌面包、跑一个 talker 与 listener 验证，最后给出卸载方式。

一、准备工作

1. 确认操作系统版本

lsb_release -a 可以查看 LSB 信息和发行版版本，输出大致长这样：

No LSB modules are available.
Distributor ID: Ubuntu
Description: Ubuntu 24.04.2 LTS
Release: 24.04
Codename: noble

记住最后一行 noble，后面配 apt 源要用它。

2. 选择与系统对应的 ROS2 版本

进 ROS2 官网文档页，按发行版代号选对应版本。每个发行版对应一个系列（如 Jazzy、Rolling），版本之间接口有差异，选错了装完跑不起来。选之前先看官网的版本说明，确认哪个系列支持 noble。

二、设置语言环境

ROS2 要求系统支持 UTF-8。如果你处在最小环境（比如 Docker 容器），区域设置可能退化成 POSIX，这时手动配一下：

locale # 检查是否 UTF-8
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
locale # 核验设置

三、启用所需仓库

先把 Ubuntu Universe 仓库打开：

sudo apt install software-properties-common
sudo add-apt-repository universe

然后添加 ROS2 的 GPG 密钥：

sudo apt update && sudo apt install curl -y
sudo curl -sSL https://raw.githubusercontent.com/ros/rosdistro/master/ros.key -o /usr/share/keyrings/ros-archive-keyring.gpg

密钥下载超时的处理

raw.githubusercontent.com 在国内访问不稳定，命令行会卡在下载这一步。现象明确时，可以先查这个域名在本地的解析地址，把查到的 IP 按 hosts 文件格式补到 /etc/hosts（用 sudo vim /etc/hosts），之后重新执行上面那条 curl 命令。注意 hosts 是本机级配置，改之前先备份，只加这一条映射，不要复制网上的整份转发列表。

密钥拿到后，把仓库写进源列表：

echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/ros-archive-keyring.gpg] http://packages.ros.org/ros2/ubuntu $(. /etc/os-release && echo $UBUNTU_CODENAME) main" | sudo tee /etc/apt/sources.list.d/ros2.list > /dev/null

四、安装 ROS2

如果还要自己编译 ROS 包，可以先装开发工具：

sudo apt update && sudo apt install ros-dev-tools

正式安装前先更新系统：

sudo apt update
sudo apt upgrade

两种安装档位：

• 桌面版（推荐）：含 ROS、RViz、演示与教程，sudo apt install ros-rolling-desktop。
• 基础版（裸）：只有通信库、消息包和命令行工具，没有 GUI 工具，sudo apt install ros-rolling-ros-base。

注意 rolling 只是本文示例里对应的系列名，实际安装时要替换成你选中的那个版本代号。

RMW 中间件

ROS2 默认使用 FastDDS 作为中间件，但 RMW 可以在运行时替换。如果项目里用到别的 DDS 实现，官方文档里有多种 RMW 共存与切换的说明，按需查阅即可。

五、设置环境

装完把环境脚本 source 一下，之后每个新终端都要做这一步（非 bash 用户把 .bash 换成对应的 .sh 或 .zsh）：

source /opt/ros/rolling/setup.bash

六、跑一个例子验证

装了桌面版的话，可以这么验：

第一个终端：

source /opt/ros/rolling/setup.bash
ros2 run demo_nodes_cpp talker

第二个终端：

source /opt/ros/rolling/setup.bash
ros2 run demo_nodes_py listener

talker 端会持续打印发布消息，listener 端回应收到的内容。两边对上，说明 C++ 与 Python 两套 API 都正常。

七、卸载

要从二进制安装切到源码安装，或者干脆卸掉：

sudo apt remove '*ros-rolling-*' && sudo apt autoremove

还要清理源列表：

sudo rm /etc/apt/sources.list.d/ros2.list
sudo apt update
sudo apt autoremove
sudo apt upgrade

qidao123.com企服评测-应用市场 编辑提示

本文按 Ubuntu 24.04（代号 noble）的实际安装顺序，整理 ROS2 的环境检查、UTF-8 区域设置、Universe 仓库启用、GPG 密钥与 apt 源配置、桌面版与基础版两种安装档位、talker 与 listener 验证方法以及卸载步骤，并给出了 raw.githubusercontent.com 拉取密钥超时时的 hosts 处理思路。改 /etc/hosts 属于影响全机解析的系统改动，操作前请备份原文件并只保留必要条目；文中 rolling 为示例系列名，请替换为与所选 ROS2 版本对应的代号。