📚 课程目录第2章 ROS2环境搭建

2、ROS2环境搭建：操作系统选择、安装ROS2、配置环境变量与测试

2.1 核心原理：为什么环境搭建决定开发效率

ROS2 不是一个独立的应用程序，而是一套运行在操作系统之上的分布式通信中间件。它依赖底层系统的 进程调度、网络协议栈、共享内存机制 以及 Python/C++ 编译器工具链。因此，操作系统的选择直接决定了 ROS2 的稳定性、社区支持力度以及后续调试的难易程度。

ROS2 采用 层叠式架构，从下至上依次为：操作系统层（Linux/Windows/macOS）、底层中间件层（DDS 实现，如 Fast DDS、Cyclone DDS）、ROS2 客户端库层（rclcpp/rclpy）、应用层。每一层都依赖下一层提供的接口。如果底层系统环境不干净（如 Python 版本冲突、缺少系统依赖、网络代理异常），即使 ROS2 安装成功，也会在运行节点通信时出现难以排查的“幽灵问题”。

核心认知：ROS2 环境搭建的本质是构建一个“可复现的依赖链”。Ubuntu 22.04 + ROS2 Humble 是当前生产环境中验证最充分、教程资源最丰富的组合，建议初学者直接采用，避免在系统兼容性上消耗过多精力。

2.2 方法流程：从零到可运行的完整安装路径

本节以 Ubuntu 22.04 LTS + ROS2 Humble 为例，这是目前教程最丰富、硬件驱动支持最完善的组合。整个流程分为四个阶段：系统准备 → 软件源配置 → 核心安装 → 环境验证。

阶段一：系统准备与基础依赖

首先确保系统为干净的 Ubuntu 22.04，并更新软件包索引。如果使用虚拟机，建议分配至少 4GB 内存和 60GB 磁盘；如果使用 Docker，则需要使用 --network=host 模式以保证 DDS 多播通信正常。

# 1. 更新系统软件包
sudo apt update && sudo apt upgrade -y

# 2. 安装基础工具（curl、git、gnupg 等）
sudo apt install -y curl gnupg lsb-release software-properties-common

# 3. 设置 UTF-8 编码（避免中文路径或日志乱码）
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

阶段二：添加 ROS2 软件源

ROS2 官方软件包托管在 packages.ros.org。需要先添加 ROS2 的 GPG 密钥，再将软件源写入 /etc/apt/sources.list.d/ 目录。注意不要使用国内镜像时混用不同发行版的源，否则会出现依赖解析失败。

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

# 2. 写入软件源（Ubuntu 22.04 对应 jammy）
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

# 3. 更新索引
sudo apt update

阶段三：安装 ROS2 Humble 桌面版

桌面版包含 RViz2 可视化工具、演示示例、仿真插件，适合学习和调试。如果磁盘空间紧张，可以只安装基础版（ros-humble-ros-base），但后续开发中大概率仍需补装 RViz2。

# 安装桌面版（包含 RViz2、演示程序、常用库）
sudo apt install -y ros-humble-desktop

# 安装编译工具（colcon 用于构建工作空间）
sudo apt install -y python3-colcon-common-extensions python3-argcomplete

# 安装 ROS2 命令行扩展（自动补全）
sudo apt install -y python3-rosdep

阶段四：配置环境变量

ROS2 的环境变量脚本位于 /opt/ros/humble/setup.bash。每次打开新终端都需要手动 source，因此建议写入 ~/.bashrc 实现自动加载。同时需要配置 ROS_DOMAIN_ID 以避免多机器人或多网络环境下的通信冲突。

# 编辑 ~/.bashrc，在末尾追加以下内容
echo "source /opt/ros/humble/setup.bash" >> ~/.bashrc
echo "export ROS_DOMAIN_ID=0" >> ~/.bashrc

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

# 验证环境变量
echo $ROS_DISTRO   # 应输出 humble
printenv | grep ROS

2.3 案例/场景：安装后的完整功能测试

环境配置完成后，必须通过实际通信测试来验证 DDS 中间件是否正常工作。以下测试分为 单机回环测试 和 双机通信测试 两个层级。

场景一：单机回环测试（C++ 与 Python 节点互通）

打开两个终端，分别运行 C++ 发布者和 Python 订阅者。如果 5 秒内能持续收到消息，说明 rclcpp 与 rclpy 均能正常访问 DDS 共享内存。

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

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

# 预期输出（终端 2 持续打印）：
# [INFO] I heard: [Hello World: 1]
# [INFO] I heard: [Hello World: 2]

场景二：RViz2 可视化验证

运行 RViz2 并加载机器人模型，验证 OpenGL 渲染与 ROS2 话题订阅是否正常。如果 RViz2 启动后黑屏或崩溃，通常与显卡驱动或 LIBGL_ALWAYS_SOFTWARE 环境变量有关。

# 启动 RViz2
ros2 run rviz2 rviz2

# 在 RViz2 中点击 "Add" → "By topic" → 选择 /rosout 话题
# 如果左侧面板能显示日志消息，说明 RViz2 与 ROS2 通信正常

场景三：命令行工具验证

使用 ros2 node list 和 ros2 topic list 检查节点发现机制。如果列表为空，说明 DDS 域代理配置异常，需要检查 ROS_DOMAIN_ID 是否一致。

# 查看当前活跃节点
ros2 node list
# 预期输出：/listener 或 /talker（取决于正在运行的节点）

# 查看话题列表
ros2 topic list
# 预期输出：/chatter  /parameter_events  /rosout

测试项目	命令	通过标准
版本检查	`ros2 --version`	输出包含 `ros2` 和版本号
节点发现	`ros2 node list`	能看到至少一个节点
话题通信	`ros2 topic echo /chatter`	持续输出消息内容
可视化	`rviz2`	窗口正常打开且无报错

2.4 误区与复盘：常见安装失败原因及对策

高频误区 1：混用 ROS1 与 ROS2 环境变量。如果之前安装过 ROS1（如 Noetic），~/.bashrc 中可能同时存在 source /opt/ros/noetic/setup.bash 和 source /opt/ros/humble/setup.bash。两个版本的 roscd、rosrun 命令会互相覆盖，导致命令找不到或版本错乱。解决方法是只保留 ROS2 的 source 行，或使用 alias ros1='source /opt/ros/noetic/setup.bash' 手动切换。

高频误区 2：忽略 DDS 实现的选择。Ubuntu 22.04 默认安装 Fast DDS，但某些工业网卡或虚拟机环境对 Fast DDS 的多播支持不佳。如果出现“节点互相看不到”的问题，可以尝试切换为 Cyclone DDS：

sudo apt install ros-humble-rmw-cyclonedds-cpp
export RMW_IMPLEMENTATION=rmw_cyclonedds_cpp

将上述 export 写入 ~/.bashrc 后重新测试。

复盘清单：安装完成后，建议按以下顺序逐项排查：

网络连通性：ping packages.ros.org 是否通？如果超时，需配置代理或使用国内镜像源。
密钥有效性：如果 apt update 报错 NO_PUBKEY，重新执行 GPG 密钥添加步骤。
Python 版本：Ubuntu 22.04 自带 Python 3.10，如果手动安装了其他版本，可能导致 rclpy 导入失败。
防火墙设置：如果开启了 ufw，需要放行 DDS 使用的 7400-7500 端口段，或直接 sudo ufw allow 7400:7500/udp。

环境搭建是 ROS2 开发中最容易“劝退”初学者的环节，但也是最有规律可循的部分。只要遵循 “系统干净 → 源正确 → 依赖完整 → 逐项验证” 的原则，绝大多数问题都能在 30 分钟内解决。完成上述安装与测试后，你的开发机已经具备运行 ROS2 节点、话题通信、参数服务和可视化调试的全部基础能力，可以进入下一阶段的工作空间创建与功能包开发。