Ubuntu 22.04安装ROS2 Humble全攻略（附避坑指南，小白也能轻松上手）

ROS2 Humble是ROS2长期支持版本，适配Ubuntu 22.04。本文提供Ubuntu 22.04安装ROS2详细步骤，涵盖环境准备、软件源配置、安装验证及常见坑点，帮助新手一次性成功。

一、准备工作：更新系统和设置locale

打开终端，执行以下命令确保系统最新：

    sudo apt update && sudo apt upgrade -y  

ROS2 Humble需要UTF-8 locale，执行：

    locale  # 检查是否含UTF-8sudo 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  

避坑1：若locale未设置UTF-8，后续编译可能报错。

二、添加ROS2源并安装

首先安装必要工具：

    sudo apt install curl gnupg lsb-release  

添加ROS2 GPG密钥：

    sudo 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 $(lsb_release -cs) main" | sudo tee /etc/apt/sources.list.d/ros2.list > /dev/null  

更新并安装ROS2 Humble桌面版：

    sudo apt updatesudo apt install ros-humble-desktop  

避坑2：国内用户建议更换apt镜像源，否则下载极慢。可参考阿里云、清华镜像站配置。

三、配置环境变量

安装完成后，需配置环境变量才能使用ROS2命令：

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

避坑3：如果使用zsh，需改为~/.zshrc。多版本ROS共存时注意source对应的版本。

四、验证安装

运行C++和Python示例测试：

    ros2 run demo_nodes_cpp talker  

新开终端，source后执行：

    ros2 run demo_nodes_py listener  

看到双方通信即成功。至此，Ubuntu安装ROS2避坑指南的核心步骤完成。

五、常见问题与解决

• 问题1：colcon build找不到包 → 检查是否已安装python3-colcon-common-extensions。
• 问题2：rosdep init失败 → 手动修改hosts或使用代理。
• 问题3：缺少依赖 → 运行rosdep install --from-paths src --ignore-src -r -y。

本文涵盖了ROS2 Humble环境配置的所有要点，只要按步骤操作，小白也能顺利搭建开发环境。