ROS2 Humble 在 Ubuntu 22.04 上的深度部署与实战调优指南

对于机器人开发者而言，一个稳定、高效的开发环境是项目成功的基石。ROS2 Humble 作为长期支持版本，与 Ubuntu 22.04 LTS 的组合，无疑是当前构建机器人应用最可靠的技术栈之一。然而，从一张白纸到功能完备的 ROS2 开发环境，中间涉及的远不止几条命令的复制粘贴。网络环境的差异、系统配置的细节、依赖关系的处理，每一个环节都可能成为阻碍你快速上手的“暗礁”。本文将带你深入每一个步骤，不仅告诉你“怎么做”，更会解释“为什么这么做”，并提供一套经过验证的、可应对常见问题的完整解决方案，助你构建一个坚如磐石的 ROS2 开发基础。

1. 系统准备与环境预配置

在安装任何大型软件栈之前，确保操作系统本身处于一个健康且标准化的状态至关重要。这能避免大量因环境不一致导致的诡异问题。

1.1 区域与语言环境标准化

ROS2 及其庞大的生态系统，包括编译工具、消息生成器等，对 UTF-8 编码环境有强依赖。非 UTF-8 环境可能导致软件包编译失败、消息显示乱码等一系列问题。因此，我们的第一步是检查和设置语言环境。

打开终端，首先查看当前设置：

locale

如果输出中 LANG、LC_ALL 等变量不是 en_US.UTF-8 或类似 UTF-8 变体，则需要按以下步骤设置。

执行以下命令序列来安装语言包、生成并启用 UTF-8 环境：

sudo apt update && sudo apt install locales -y
sudo locale-gen en_US en_US.UTF-8
sudo update-locale LC_ALL=en_US.UTF-8 LANG=en_US.UTF-8

接下来，为当前终端会话设置环境变量，并验证是否生效：

export LANG=en_US.UTF-8
locale  # 再次检查，确认输出均为 UTF-8

注意：update-locale 命令修改的是系统全局配置，对未来所有新登录会话生效。而 export 命令仅对当前终端窗口有效。为了永久生效，我们通常会将 export LANG=en_US.UTF-8 添加到 ~/.bashrc 文件中，但上述 update-locale 已经完成了这项工作。

1.2 系统软件源优化与基础工具安装

Ubuntu 默认的软件源服务器可能在国外，访问速度不稳定。为了加速后续大量软件的下载过程，建议更换为国内镜像源，例如清华大学 TUNA 镜像源。

备份原始源列表文件后，使用 sed 命令进行一键替换：

sudo cp /etc/apt/sources.list /etc/apt/sources.list.bak
sudo sed -i 's@//.*archive.ubuntu.com@//mirrors.tuna.tsinghua.edu.cn@g' /etc/apt/sources.list
sudo sed -i 's@//.*security.ubuntu.com@//mirrors.tuna.tsinghua.edu.cn@g' /etc/apt/sources.list

更新软件包列表，并升级所有已安装的软件到最新版本，确保系统底层的稳定性：

sudo apt update
sudo apt upgrade -y

安装后续步骤必需的工具：

  • curl: 用于从网络下载文件（如 GPG 密钥）。
  • gnupg: 用于管理加密密钥，验证软件源的真实性。
  • lsb-release: 用于方便地获取系统发行版信息。
  • software-properties-common: 提供 add-apt-repository 命令，用于管理软件源仓库。
sudo apt install curl gnupg lsb-release software-properties-common -y

2. ROS2 Humble 软件源添加与密钥信任

ROS2 并非 Ubuntu 官方仓库的一部分，因此我们需要将其官方（或镜像）仓库添加到系统的软件源列表中，并信任其发布的软件包签名密钥。

2.1 启用 Universe 仓库

Ubuntu 的 universe 仓库包含大量由社区维护的开源软件，ROS2 的一些依赖包位于其中。

sudo add-apt-repository universe

2.2 获取并信任 ROS2 GPG 密钥

这是保证软件包完整性和来源真实性的关键一步。我们将从 ROS 官方服务器下载其公钥，并安装到系统受信任的密钥环中。

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

关键问题排查： 如果执行上述命令时遇到类似 Failed to connect to raw.githubusercontent.com 的错误，这通常是由于网络 DNS 解析问题。我们可以通过修改 /etc/hosts 文件，为该域名手动指定一个可访问的 IP 地址来解决。

  1. 查询当前可用的 IP：

    nslookup raw.githubusercontent.com

    从输出中选取一个响应快的 IP 地址，例如 185.199.108.133。

  2. 编辑 hosts 文件：

    sudo gedit /etc/hosts

    在文件末尾添加一行（IP 地址请替换为你查询到的）：

    185.199.108.133 raw.githubusercontent.com

    保存并退出，然后重试 curl 下载命令。

2.3 添加 ROS2 Apt 软件源

现在，我们将 ROS2 的软件仓库地址添加到系统。这条命令会自动获取你系统的架构（amd64/arm64）和 Ubuntu 版本代号（如 Jammy），并生成正确的源地址。

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

命令分解说明：

  • deb: 声明这是一个二进制软件仓库。
  • arch=$(dpkg --print-architecture): 动态获取并指定系统架构。
  • signed-by=...: 指定用于验证此仓库的 GPG 密钥路径。
  • http://packages.ros.org/ros2/ubuntu: ROS2 官方软件仓库地址。
  • $(source /etc/os-release && echo $UBUNTU_CODENAME): 动态获取 Ubuntu 版本代号（如 jammy）。
  • main: 仓库的组件分支。
  • tee /etc/apt/sources.list.d/ros2.list: 将生成的源字符串写入到 /etc/apt/sources.list.d/ 目录下的一个新文件中，这是管理第三方源的最佳实践。

完成后，再次更新软件包列表，让系统识别新添加的 ROS2 源：

sudo apt update

3. ROS2 Humble 核心组件安装与选型

ROS2 提供了不同层次的安装选项，你可以根据开发需求进行选择。

3.1 安装选项对比与选择

在正式安装前，我们先了解几个主要的软件包：

软件包名称包含内容适用场景安装体积
ros-humble-desktopROS2 核心库、基础工具（CLI）、RViz2、RQt、示例节点、教程桌面开发推荐。适合绝大多数学习和开发，提供完整的图形化工具链。约 800 MB
ros-humble-ros-baseROS2 核心库、通信中间件（DDS）、消息工具、命令行工具无头服务器或资源受限环境。仅包含运行时和核心开发库，无 GUI 工具。约 400 MB
ros-dev-toolscolcon 构建工具、rosdep 依赖管理工具等所有开发场景必备。用于编译、构建和管理你自己的 ROS2 功能包。

对于初次接触 ROS2 或需要进行仿真、可视化调试的开发者，强烈推荐安装 ros-humble-desktop。它将为你提供一个开箱即用的完整环境。

3.2 执行安装命令

确保系统已更新到最新状态，然后安装桌面完整版和开发工具：

sudo apt upgrade -y
sudo apt install ros-humble-desktop -y
sudo apt install ros-dev-tools -y

安装过程会持续一段时间，并自动处理所有复杂的依赖关系。期间可能会提示你确认磁盘空间使用，输入 y 并按回车继续即可。

3.3 环境变量配置

安装完成后，ROS2 的核心文件位于 /opt/ros/humble/ 目录下。为了让系统在任何终端中都能识别 ros2 等命令，我们需要将其 setup 脚本的路径加入到 shell 的环境变量中。

为当前终端会话激活 ROS2 环境：

source /opt/ros/humble/setup.bash

现在，你可以在当前终端里尝试运行 ros2 --help 来验证命令是否可用。

使 ROS2 环境在每次打开新终端时自动生效： 将 source 命令添加到用户的 bash 配置文件中。

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

这样，每次启动新的终端窗口，ROS2 环境都会被自动加载。要使当前终端立即应用这个永久设置，可以执行：

source ~/.bashrc

4. 安装验证、进阶配置与故障排除

一个成功的安装，需要通过实际运行来验证。同时，配置一些常用工具能极大提升开发效率。

4.1 基础通信测试：Talker-Listener 示例

这是 ROS2 官方提供的经典测试，用于验证 DDS 中间件通信是否正常。

  1. 启动发布者节点：打开第一个终端，运行 C++ 版本的 talker。

    ros2 run demo_nodes_cpp talker

    你应该能看到持续输出的日志，显示它正在发布 Hello World 消息。

  2. 启动订阅者节点：打开第二个终端，运行 Python 版本的 listener。

    ros2 run demo_nodes_py listener

    如果一切正常，第二个终端将实时打印出从 talker 那里接收到的 Hello World 消息。

这个测试证明了：

  • ROS2 核心功能安装正确。
  • C++ 和 Python 客户端库工作正常。
  • 默认的 DDS 实现（Cyclone DDS）能够在本机进行进程间通信。

4.2 图形化界面测试：小海龟仿真器

如果你的安装包含了桌面版，那么 turtlesim 这个经典的图形化示例是必玩的测试。

  1. 启动海龟仿真器节点：

    ros2 run turtlesim turtlesim_node

    一个带有随机小海龟的蓝色窗口将会弹出。

  2. 启动键盘控制节点： 打开新终端，运行：

    ros2 run turtlesim turtle_teleop_key

    保持这个终端为焦点，使用键盘上的 方向键 就可以控制蓝色窗口中的小海龟移动了。

这个测试验证了 GUI 相关组件、节点间的话题通信以及基础的消息类型都已就绪。

4.3 关键开发工具安装与配置

1. 自动补全工具： 为 ros2 命令行工具安装参数自动补全功能，能节省大量记忆和输入时间。

sudo apt install python3-argcomplete -y

2. 国内开发者必备：rosdepc ROS 的依赖管理工具 rosdep 在初始化时默认访问 GitHub，速度极慢且容易失败。国内社区维护了镜像工具 rosdepc。

首先安装 rosdepc：

sudo apt install python3-pip
sudo pip3 install rosdepc -i https://pypi.tuna.tsinghua.edu.cn/simple

然后使用 rosdepc 进行初始化（只需执行一次）：

sudo rosdepc init
rosdepc update

未来，当你编译自己或第三方 ROS2 功能包时，就可以用 rosdepc install 来快速安装系统依赖了。

4.4 常见安装问题与解决方案

即使遵循步骤，也可能遇到问题。这里汇总几个典型情况：

  • 问题：sudo apt update 时报告 GPG 密钥错误 NO_PUBKEY F42ED6FBAB17C654 原因：ROS 软件源的 GPG 密钥未被正确添加或信任。 解决：重新执行 2.2 和 2.3 节添加密钥和源的命令。确保 curl 下载密钥时没有报错。也可以尝试手动导入：

    sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv-keys F42ED6FBAB17C654

  • 问题：安装 ros-humble-desktop 时出现大量“无法满足依赖关系”错误 原因：可能是系统软件源列表混乱、部分仓库未启用，或之前安装的软件包存在冲突。 解决：

    1. 检查 /etc/apt/sources.list 和 /etc/apt/sources.list.d/ 下的文件，确保没有重复或冲突的源。
    2. 运行 sudo apt update && sudo apt upgrade 确保系统完全更新。
    3. 尝试使用 apt 的修复功能：sudo apt --fix-broken install。
    4. 如果问题依旧，考虑使用更彻底的清理和重装方法（见下文卸载部分）。

  • 问题：运行 ros2 命令提示“未找到命令” 原因：环境变量未正确设置。 解决：

    1. 确认已执行 source /opt/ros/humble/setup.bash。
    2. 确认 ~/.bashrc 文件中已添加 source 行，并且已通过 source ~/.bashrc 重新加载。
    3. 检查 echo $ROS_DISTRO 输出是否为 humble。

4.5 如何彻底卸载 ROS2 Humble

如果你需要重新安装或清理环境，可以按以下顺序操作：

# 1. 移除所有 ROS2 Humble 相关的软件包
sudo apt remove ~nros-humble-* && sudo apt autoremove -y

# 2. 移除 ROS2 软件源列表文件
sudo rm /etc/apt/sources.list.d/ros2.list

# 3. 清理并更新软件包列表
sudo apt update
sudo apt autoremove -y
sudo apt upgrade -y

# 4. （可选）从 .bashrc 中移除 source 行
# 使用文本编辑器打开 ~/.bashrc，手动删除添加的 `source /opt/ros/humble/setup.bash` 那一行。

执行完这些步骤后，ROS2 Humble 就从你的系统中被移除了。你可以从头开始一个干净的安装流程。

走到这里，你的 Ubuntu 22.04 系统上已经拥有了一个功能完整、配置妥当的 ROS2 Humble 开发环境。从基础的命令行测试到图形化仿真，核心组件均已就位。更重要的是，通过理解每个步骤背后的原理并掌握了关键工具的配置（如 rosdepc），你不仅完成了一次安装，更是为后续顺畅的机器人软件开发铺平了道路。接下来，你就可以着手创建自己的工作空间，开始探索 ROS2 强大的节点、话题、服务等核心概念，将你的机器人创意付诸实践了。

Logo
乐奇 Rokid 开放社区

更多推荐

cover

智能眼镜新品扎堆：AR、VR、MR到底怎么分？

avatar 乐奇 Rokid 开放社区

FPC与机器人的双向赋能，解锁智能装备进化新势能

如果说AI算法、算力芯片是智能眼镜的“智慧大脑”，光学模组是智能眼镜的“视觉窗口”，那么FPC就是贯穿整机、连接所有功能模块的“柔性神经脉络”。方寸之间的柔性突破，破解了智能眼镜“轻薄形态”与“全能功能”的核心矛盾，是穿戴智能设备实现形态革新、体验升级的底层核心。未来，随着AR沉浸式技术、AI大模型、穿戴硬件技术的持续进化，智能眼镜将朝着更轻薄、更智能、更多场景、更高稳定性的方向持续迭代，对高端精

avatar 乐奇 Rokid 开放社区
cover

AI眼镜里面有晶振吗？智能眼镜的时钟系统

avatar 乐奇 Rokid 开放社区