Ubuntu 22.04安装ROS2 Humble全攻略（手把手教你避开安装常见坑）

在机器人开发领域，ROS2 Humble 是目前针对 Ubuntu 22.04 (Jammy Jellyfish) 最稳定且推荐的长期支持版本（LTS）。对于小白用户来说，初次安装往往会遇到网络连接超时、密钥失效或环境配置不生效等“坑”。本文将为你提供一份全流程避坑指南。

一、准备工作：检查系统环境

在正式安装 ROS2安装教程 之前，请确保你的 Ubuntu 22.04 系统语言环境支持 UTF-8。这是为了防止后续编译或运行节点时出现乱码字符。

locale  # 检查是否包含 UTF-8sudo apt update && sudo apt install localessudo locale-gen en_US en_US.UTF-8sudo update-locale LC_ALL=en_US.UTF-8 LANG=en_US.UTF-8export LANG=en_US.UTF-8

二、添加 ROS2 软件源（解决下载慢的问题）

这一步是“避坑”的关键。直接使用官方源在国内可能会非常缓慢甚至连接失败，我们建议通过镜像站添加官方授权的 GPG 密钥和源地址。

sudo apt install software-properties-commonsudo add-apt-repository universitysudo apt update && sudo apt install curl -ysudo curl -sSL https://raw.githubusercontent.com/ros/rosdistro/master/ros.key -o /usr/share/keyrings/ros-archive-keyring.gpgecho "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 Humble

更新索引后，我们安装“桌面完整版”，它包含了 机器人开发 所需的核心库、Rviz 可视化工具和模拟器。

sudo apt updatesudo apt install ros-humble-desktop

四、配置环境变量（避开命令找不到的坑）

安装完成后，如果你直接输入 ros2 发现报错，那是因为没有配置环境变量。我们需要将 source 命令写入 bash 配置文件中。

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

五、安装完成后的测试

打开两个终端，分别运行以下命令，如果看到“Publishing: Hello World”和“I heard: Hello World”的互动，恭喜你，机器人操作系统 ROS2 已经在你的 Ubuntu 22.04 上完美运行了！

• 终端 1: ros2 run demo_nodes_cpp talker
• 终端 2: ros2 run demo_nodes_py listener

本文涉及的关键词：Ubuntu 22.04, ROS2 Humble, 机器人开发, ROS2安装教程