2、ROS2环境搭建：Ubuntu系统配置、ROS2发行版选择、安装步骤、环境变量设置、验证安装

ROS2（Robot Operating System 2）作为新一代机器人中间件，其环境搭建的质量直接决定了后续开发调试的效率与稳定性。与ROS1相比，ROS2引入了DDS（Data Distribution Service）通信机制，对操作系统版本、编译器、Python环境以及网络配置有更严格的要求。本章将围绕Ubuntu系统配置、发行版选型、安装流程、环境变量持久化以及安装验证五个核心环节展开，帮助读者构建一个干净、可复现且适合机器人控制开发的ROS2工作环境。

2.1 Ubuntu系统配置：打好底层基础

核心原理：ROS2对操作系统有明确的版本依赖，其底层依赖的DDS实现（如Fast DDS、Cyclone DDS）与Linux内核版本、GCC编译器版本以及Python解释器版本紧密耦合。Ubuntu LTS（长期支持）版本因其稳定性和长达五年的安全更新周期，是ROS2官方支持的首选平台。系统配置的核心目标在于：确保网络可达性（用于下载软件包）、设置正确的软件源（包括Ubuntu Universe仓库和ROS2官方仓库）、配置字符编码（UTF-8）以及安装必要的系统依赖（如git、curl、gnupg）。

操作流程：以下为Ubuntu 22.04 LTS（Jammy）的基础配置步骤，这也是ROS2 Humble官方推荐的组合。

1. 更新软件源：打开终端，执行 sudo apt update && sudo apt upgrade -y，确保系统所有现有软件包均为最新版本，避免后续安装时出现依赖版本过旧的问题。
2. 设置UTF-8编码：ROS2的Python脚本对locale敏感，非UTF-8环境可能导致日志输出乱码或某些工具异常。执行以下命令设置locale：

sudo apt install -y locales
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

3. 启用Universe仓库：ROS2核心包依赖Ubuntu Universe仓库中的软件。执行 sudo apt install software-properties-common 后，通过 sudo add-apt-repository universe 启用该仓库。
4. 安装基础开发工具：包括 curl（用于下载ROS2密钥）、gnupg（用于密钥验证）、git（版本控制）、build-essential（编译工具链）。

2.2 ROS2发行版选择：匹配Ubuntu版本

核心原理：ROS2发行版与Ubuntu版本存在严格的映射关系。每个ROS2发行版在发布时，会针对特定的Ubuntu LTS版本进行完整测试与优化。选择错误的组合会导致依赖库版本冲突、编译失败或运行时崩溃。下表列出了当前主流ROS2发行版与Ubuntu版本的对应关系：

判断方法：选择发行版时，应遵循“先定Ubuntu版本，再选ROS2版本”的原则。若你正在使用Ubuntu 22.04，则Humble是唯一推荐的LTS选项。若你计划使用Ubuntu 24.04，则Jazzy是当前最合适的选择。对于机器人控制类课程，我们推荐使用Ubuntu 22.04 + ROS2 Humble组合，因为该组合经过两年多的社区验证，资料丰富，且与大多数工业级机器人硬件驱动兼容性最好。

2.3 安装步骤：从密钥到核心组件

操作流程：以下以Ubuntu 22.04 + ROS2 Humble为例，展示完整的安装命令序列。整个过程分为四个阶段：添加ROS2软件源、安装核心包、安装开发工具、安装编译工具。

阶段一：添加ROS2软件源与密钥

# 添加ROS2 GPG密钥
sudo curl -sSL https://raw.githubusercontent.com/ros/rosdistro/master/ros.key -o /usr/share/keyrings/ros-archive-keyring.gpg

# 添加ROS2 apt源
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

# 更新软件源
sudo apt update

阶段二：安装ROS2核心包

# 安装完整桌面版（包含RViz、演示示例、教程）
sudo apt install -y ros-humble-desktop

# 若仅需基础通信功能（无图形界面），可安装基础版
# sudo apt install -y ros-humble-ros-base

阶段三：安装开发工具与依赖管理工具

# 安装编译工具colcon、测试工具、rosdep依赖管理器
sudo apt install -y python3-colcon-common-extensions python3-rosdep python3-argcomplete

# 初始化rosdep（用于后续自动安装项目依赖）
sudo rosdep init
rosdep update

阶段四：安装Python与C++接口（可选但推荐）

# 安装Python接口（rclpy）与C++接口（rclcpp）的额外依赖
sudo apt install -y python3-pip python3-venv
sudo apt install -y ros-humble-rclcpp ros-humble-rclpy

2.4 环境变量设置：让系统找到ROS2

核心原理：ROS2安装完成后，其可执行文件、库文件和Python模块位于 /opt/ros/humble/ 目录下。系统默认不会自动搜索该目录，必须通过source命令加载环境设置脚本，将ROS2的路径添加到 PATH、LD_LIBRARY_PATH、PYTHONPATH 等环境变量中。若每次打开新终端都需要手动source，不仅效率低下，且容易遗漏。

操作流程：将source命令写入 ~/.bashrc 文件，实现自动加载。

# 编辑bashrc文件
echo "source /opt/ros/humble/setup.bash" >> ~/.bashrc

# 使配置立即生效
source ~/.bashrc

# 验证环境变量是否生效
echo $ROS_DISTRO

若上述命令输出 humble，则说明环境变量设置成功。此外，对于使用zsh的用户，应将 setup.bash 替换为 setup.zsh，并写入 ~/.zshrc。

2.5 验证安装：确保系统可用

判断方法：安装验证分为三个层次：版本信息验证、基础命令验证、通信功能验证。只有三层全部通过，才能确认ROS2环境搭建成功。

第一层：版本信息验证

# 查看ROS2版本
ros2 --version

# 查看已安装的包列表（应包含rclcpp、rclpy等）
ros2 pkg list | grep rcl

第二层：基础命令验证

# 启动C++ talker节点
ros2 run demo_nodes_cpp talker

若终端持续输出 [INFO] [timestamp]: Publishing: 'Hello World: N'，则说明C++通信节点运行正常。按 Ctrl+C 停止。

第三层：通信功能验证（核心）

打开两个终端，分别运行talker和listener节点，验证ROS2的DDS通信是否正常。

# 终端1：运行发布者
ros2 run demo_nodes_cpp talker

# 终端2：运行订阅者
ros2 run demo_nodes_py listener

若终端2持续输出 [INFO] [timestamp]: I heard: 'Hello World: N'，则说明ROS2的发布-订阅通信链路完全打通。

2.6 总结复盘：环境搭建的关键要点

ROS2环境搭建看似简单，但实际项目中频繁出现的排障问题往往源于基础配置的疏漏。以下是本节的要点总结：

• 版本匹配是前提：Ubuntu 22.04 ↔ Humble，Ubuntu 24.04 ↔ Jazzy，严格遵循官方映射表，避免混用。
• 软件源与网络是基础：使用国内镜像源可大幅提升安装成功率；添加ROS2源时注意变量展开问题。
• 环境变量持久化：务必写入 ~/.bashrc，并注意source顺序（先ROS2，后工作空间）。
• 验证必须完整：版本查询 + 节点运行 + 通信测试三层验证缺一不可。
• 排障入口明确：遇到 Package not found 优先检查源配置；遇到通信失败优先检查防火墙和DDS配置。