Ubuntu 22.04安装ROS2全攻略（手把手避坑指南）

1. 准备工作：更新系统

打开终端（Ctrl+Alt+T），先确保系统包是最新的：

    sudo apt update && sudo apt upgrade -y  

这一步可以避免后续因依赖版本过旧导致的安装失败。

2. 设置locale（防止中文乱码）

ROS2需要UTF-8环境，执行：

    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  

3. 添加ROS2软件源

首先安装必要工具并添加ROS2 GPG密钥：

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

然后将ROS2仓库添加到源列表：

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

避坑点：如果遇到网络问题无法下载密钥，可以手动下载或更换镜像源（如清华源）。

4. 安装ROS2 Humble

更新包索引并安装ROS2基础版（推荐安装桌面版，包含GUI工具）：

    sudo apt updatesudo apt install ros-humble-desktop  

如果想最小化安装，可以用ros-humble-ros-base。安装过程可能耗时较长，取决于网络。

5. 设置环境变量

每次使用ROS2前都需要source环境，建议添加到bashrc中：

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

验证是否生效：echo $ROS_DISTRO，应输出humble。

6. 安装开发工具和依赖

为了后续编译工作空间，安装colcon等工具：

    sudo apt install python3-colcon-common-extensions python3-rosdep  

初始化rosdep：

    sudo rosdep initrosdep update  

7. 测试安装：运行小乌龟示例

打开两个终端，分别运行：

终端1：

    ros2 run turtlesim turtlesim_node  

终端2：

    ros2 run turtlesim turtle_teleop_key  

如果能出现小乌龟窗口并用键盘控制，说明ROS2安装成功！

8. 避坑指南汇总

• 网络问题：添加密钥或下载包时失败，可尝试使用代理或更换国内镜像源（如中科大、清华源）。
• Python版本：Ubuntu 22.04默认Python3.10，与ROS2 Humble完全兼容，无需额外配置。
• 环境变量未生效：记得source ~/.bashrc，或重启终端。
• 权限问题：避免使用sudo运行ROS2命令，以免破坏环境。

至此，你已经完成了完整的ROS2安装教程，在Ubuntu22.04配置ROS2的过程中没有踩坑！接下来可以开始你的ROS2环境搭建后的第一个项目啦。