关于 Ubuntu22.0.4下载ros2时,无法定位软件包ros-humble-desktop 的解决办法

目录

一.遇到的问题

二.关键原因与解决步骤

三.操作流程

1.‌确认系统版本与架构

2.启用Universe仓库

3.‌添加 ROS 2 GPG 密钥与软件源

4.‌更新包列表并安装

四.若仍失败，尝试以下备选方案

五.安装后设置环境

一.遇到的问题

“E: Unable to locate package ros-humble-desktop”

出现这个问题/错误的原因，通常是因为系统环境不满足 ROS 2 Humble 的官方安装要求，或软件源配置不正确。

二.关键原因与解决步骤

• ‌ROS 2 Humble 仅官方支持 Ubuntu 22.04 (Jammy Jellyfish) 的 64 位系统‌ ‌。
• 若系统版本不符（如 Ubuntu 20.04、32 位系统等），或软件源未正确配置，apt将无法定位该包。

三.操作流程

1.‌确认系统版本与架构

lsb_release -a uname -m

确保输出为 ‌Ubuntu 22.04.x LTS‌ 且架构为 ‌x86_64‌（非 armhf 或其他）‌

2.启用Universe仓库

sudo add-apt-repository universe

3.‌添加 ROS 2 GPG 密钥与软件源

sudo apt update && sudo apt install curl -y curl -s https://raw.githubusercontent.com/ros/rosdistro/master/ros.asc | sudo gpg --dearmor -o /usr/share/keyrings/ros-archive-keyring.gpg 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 $VERSION_CODENAME) main" | sudo tee /etc/apt/sources.list.d/ros2.list > /dev/null

4.‌更新包列表并安装

sudo apt update sudo apt install ros-humble-desktop

四.若仍失败，尝试以下备选方案

‌1.使用国内镜像源加速‌（推荐国内用户）‌：

sudo sed -i 's/http:\/\/packages.ros.org\/ros2\/ubuntu/https:\/\/mirrors.tuna.tsinghua.edu.cn\/ros\/ros2\/ubuntu/g' /etc/apt/sources.list.d/ros2.list sudo apt update sudo apt install ros-humble-desktop

2‌.尝试安装基础版验证是否为桌面组件问题‌：

sudo apt install ros-humble-ros-base

‌3.源码编译安装‌（适用于非官方支持环境）‌：
若系统确实不兼容（如 Ubuntu 20.04），可参考 源码安装指南 编译安装 ROS 2 Humble。

五.安装后设置环境

1.安装完成后，在~/.bashrc中添加：

echo "source /opt/ros/humble/setup.bash" >> ~/.bashrc source ~/.bashrc

2.‌验证安装‌
运行测试节点：

ros2 --help ros2 run demo_nodes_cpp talker # 在一个终端运行 ros2 run demo_nodes_py listener # 在另一个终端运行

若看到talker发送消息、listener接收，则安装成功。

如需进一步帮助，可提供lsb_release -a和uname -m的输出结果以便精准诊断。

3.小海龟仿真测试

这里我们需要用到两个终端，分别使用如下命令：

# 终端一 ros2 run turtlesim turtlesim_node # 终端二 ros2 run turtlesim turtle_teleop_key

第一句指令将启动一个蓝色背景的海龟仿真器，第二句指令将启动一个键盘控制节点，在该终端中用键盘上的“↑↓←→”按键，就可以控制小海龟运动了。

当出现下图的时候，即证明安装没有问题：