手把手教你ROS2 Humble安装（Ubuntu 22.04 保姆级图文教程）

第一步：准备工作与环境配置

在正式开始安装之前，我们需要确保系统语言环境是正确的，这是避免许多奇怪问题的第一步。

打开你的终端（Terminal），输入以下命令来检查并设置UTF-8编码：

# 检查是否支持UTF-8locale# 安装locale相关工具并生成环境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# 再次验证设置locale  

设置完成后，建议重启终端或重新加载配置 source ~/.bashrc。

第二步：添加ROS 2 软件源

Ubuntu的软件仓库默认不包含ROS2的软件包，因此我们需要手动添加ROS2的APT源和GPG密钥，以确保系统能够找到并信任这些包。

# 确保Ubuntu Universe仓库已启用sudo apt install software-properties-commonsudo add-apt-repository universe# 更新系统包列表并安装curlsudo apt update && sudo apt install curl -y# 添加ROS2的GPG密钥sudo 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 $(. /etc/os-release && echo $UBUNTU_CODENAME) main" | sudo tee /etc/apt/sources.list.d/ros2.list > /dev/null  

第三步：安装ROS2 Humble

源添加成功后，就可以开始安装了。首先更新apt缓存，然后选择你想要安装的版本。对于大多数新手和开发者来说，安装完整的桌面版（Desktop）是最佳选择，它包含了核心库、工具以及图形化界面相关的包（如RViz2）-4。

# 更新软件包列表sudo apt update# 升级已安装的包（可选但推荐）sudo apt upgrade -y# 安装ROS2 Humble 桌面版sudo apt install ros-humble-desktop -y# 安装开发工具：编译器和构建工具（未来开发工作空间必用）sudo apt install ros-dev-tools -y  

第四步：设置环境变量

安装完成后，每次使用ROS2命令前，都需要加载其环境配置文件。为了避免每次打开新终端都要手动输入，我们将其写入到 ~/.bashrc 文件中，实现永久生效 -5-1。

# 将ROS2环境配置脚本添加到.bashrcecho "source /opt/ros/humble/setup.bash" >> ~/.bashrc# 立即生效source ~/.bashrc  

第五步：验证安装（经典小乌龟）

激动人心的时刻到了！让我们通过经典的"小乌龟"例子来验证ROS2是否安装成功。你需要打开两个终端窗口。

在第一个终端中启动乌龟模拟器节点：

ros2 run turtlesim turtlesim_node  

你应该会看到一个蓝色窗口中出现一只静态的小乌龟。

在第二个终端中启动键盘控制节点：

ros2 run turtlesim turtle_teleop_key  

确保第二个终端是激活状态（鼠标点击一下），然后按键盘上的方向键，如果小乌龟开始移动并在身后留下轨迹，那么恭喜你，ROS2 Humble教程 的核心部分已经圆满完成，你的机器人操作系统安装 成功了！-3

常见问题与解决建议

1. 依赖问题： 如果遇到 "依赖无法满足" 的错误，首先确认你的Ubuntu版本确实是22.04。然后尝试 sudo apt install -f 来修复破损的依赖 -7。

2. 网络问题： 国内用户如果在添加GPG密钥或下载时遇到困难，可以尝试更换网络或参考镜像源教程。例如，有名的"小鱼一键安装"脚本提供了更便捷的方式，但手动安装有助于理解每一步的原理 -3-8。

3. 找不到命令： 如果输入 ros2 提示找不到命令，请再次确认你是否正确执行了第四步的环境变量设置，并在同一个终端中运行了 source ~/.bashrc。

结语

至此，你已经成功在 Ubuntu 22.04 上搭建好了 ROS2 Humble 环境。这仅仅是探索ROS2世界的第一步，后续你还可以尝试安装Gazebo进行仿真，或者学习如何使用Nav2、MoveIt2等强大的框架 -1-6。祝你在机器人开发的旅程中一帆风顺！