Ubuntu 22.04安装ROS2 Humble全攻略：手把手教你搭建机器人开发环境

第一步：设置编码（Locale）

ROS 2 需要支持 UTF-8 的环境。如果环境编码不对，安装过程中可能会出现莫名其妙的字符错误。

sudo 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

第二步：添加 ROS 2 软件源

首先需要确保 Ubuntu 的 Universe 存储库已启用，然后添加 ROS 2 的 GPG 密钥和官方源。

# 启用 Universe 库sudo add-apt-repository university# 安装 curl 并下载密钥sudo 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.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 $UBUNTU_CODENAME) main" | sudo tee /etc/apt/sources.list.d/ros2.list > /dev/null

第三步：正式安装 ROS 2 Humble

更新系统源后，建议小白直接安装“桌面版”，它包含了核心库、仿真工具以及常用的演示 Demo。

sudo apt updatesudo apt upgradesudo apt install ros-humble-desktop

第四步：环境配置（Source）

为了让每个新终端都能识别 ROS 指令，需要将 setup 脚本添加到系统配置文件中。

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

避坑指南：小白必看的注意事项

• 网络连接失败： 如果无法访问 GitHub 获取密钥，建议使用国内镜像源（如清华大学或华为云镜像）。
• rosdep init 报错： 这是最常见的问题，通常是由于网络原因。可以使用国内开发的 rosdepc 工具替代。
• 依赖冲突： 确保你的 Ubuntu 系统是刚安装后的干净状态，或者是已经移除了其他版本的 ROS。
• 硬件加速： 在虚拟机中安装时，请务必开启“3D 图形加速”，否则 Rviz2 可能无法打开。

第五步：运行测试 Demo

打开两个终端，分别输入以下命令。如果看到 "I heard" 消息，恭喜你，ROS 2 环境搭建成功！

终端 A（Talker）：ros2 run demo_nodes_cpp talker

终端 B（Listener）：ros2 run demo_nodes_py listener