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

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

2.1 核心原理：为什么ROS2离不开Linux环境

ROS2并非一个独立的操作系统，而是一套运行在Linux之上的机器人中间件框架。它依赖Linux内核提供的进程调度、网络协议栈、设备驱动管理以及文件系统权限机制。Ubuntu是ROS2官方支持最完善、社区验证最充分的发行版，绝大多数教程、二进制包和硬件驱动都优先针对Ubuntu发布。选择Ubuntu意味着你能够获得最稳定的依赖兼容性，避免在编译源码或运行节点时遇到“库版本不匹配”的隐性错误。

从系统架构角度看，ROS2的底层通信基于DDS（Data Distribution Service），而DDS实现（如Fast DDS、Cyclone DDS）需要Linux的实时调度能力和多网卡路由支持。Windows或macOS虽然可以部分运行ROS2，但在串口权限、内核级实时补丁、Docker容器透传等方面存在诸多限制。因此，“Ubuntu + ROS2”是当前机器人开发的事实标准组合，理解这一原理有助于你后续排查环境问题时快速定位方向。

  环境选择决策树：
  若你已有Ubuntu 22.04/24.04物理机或虚拟机 → 直接进入2.3节安装ROS2
若你使用Windows/macOS → 推荐安装VMware/VirtualBox虚拟机，分配≥4GB内存、≥50GB磁盘
若你使用树莓派等ARM设备 → 选择Ubuntu Server 22.04 ARM版，安装方式与x86一致
若你追求极致性能 → 双系统安装Ubuntu，避免虚拟机I/O损耗

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

安装ROS2的流程可以归纳为四个阶段：系统准备 → 软件源配置 → 核心包安装 → 环境初始化。每个阶段都有必须验证的检查点，跳过任何一步都可能导致后续运行时报出难以理解的错误。

阶段一：系统准备与软件源更新

# 1. 检查Ubuntu版本（必须为22.04或24.04）
lsb_release -a

# 2. 更新软件包索引
sudo apt update
sudo apt upgrade -y

# 3. 安装基础依赖（curl和软件源管理工具）
sudo apt install -y curl gnupg2 lsb-release

阶段二：配置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 $(lsb_release -cs) main" | \
  sudo tee /etc/apt/sources.list.d/ros2.list > /dev/null

# 更新索引
sudo apt update

阶段三：安装ROS2核心包

# 安装桌面版（包含GUI工具、模拟器和示例）
sudo apt install -y ros-humble-desktop

# 若磁盘空间有限，可仅安装基础版
# sudo apt install -y ros-humble-ros-base

# 安装开发工具（编译和调试必需）
sudo apt install -y python3-colcon-common-extensions python3-rosdep

阶段四：环境变量配置与初始化

# 将ROS2环境变量写入bashrc，每次终端自动加载
echo "source /opt/ros/humble/setup.bash" >> ~/.bashrc
source ~/.bashrc

# 初始化rosdep（用于后续管理依赖）
sudo rosdep init
rosdep update

版本选择建议：若你使用Ubuntu 22.04，推荐安装ROS2 Humble（LTS版本，支持至2027年）；若使用Ubuntu 24.04，则选择ROS2 Jazzy（LTS版本）。非LTS版本（如Iron）适合尝鲜，但不建议用于长期项目开发。

2.3 案例实战：安装后的完整验证流程

安装完成不等于环境可用，必须通过以下三个层级的测试来确认系统状态。我们以Humble版本为例，执行一套标准验证流程。

测试1：环境变量加载验证

# 检查ROS_DISTRO是否已正确设置
echo $ROS_DISTRO
# 预期输出：humble

# 检查ROS2命令是否可用
which ros2
# 预期输出：/opt/ros/humble/bin/ros2

测试2：核心节点通信测试

# 终端1：启动talker节点
ros2 run demo_nodes_cpp talker

# 终端2：启动listener节点
ros2 run demo_nodes_py listener

# 若看到双方持续输出消息，说明通信正常
# talker输出示例：[INFO] Publishing: "Hello World: 42"
# listener输出示例：[INFO] I heard: "Hello World: 42"

测试3：命令行工具验证

# 查看当前活跃节点列表
ros2 node list
# 预期输出：/talker 和 /listener

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

# 查看话题消息频率
ros2 topic hz /chatter
# 预期输出：average rate: 10.000 Hz

测试项目	命令	预期结果	失败排查方向
环境变量	`echo $ROS_DISTRO`	输出humble	检查~/.bashrc中source路径
节点通信	`ros2 run demo_nodes_cpp talker`	持续发布消息	检查DDS网络配置
话题列表	`ros2 topic list`	显示/chatter	确认talker节点仍在运行
消息频率	`ros2 topic hz /chatter`	约10Hz	检查CPU负载或网络延迟

2.4 误区与复盘：常见安装陷阱及解决方案

在数百名学员的安装过程中，以下问题出现频率最高。提前了解这些坑，能为你节省大量排查时间。

误区1：混淆ROS1与ROS2的软件源
ROS1（Noetic）和ROS2（Humble）使用完全不同的apt源。若你之前安装过ROS1，务必确认/etc/apt/sources.list.d/下没有残留的ROS1源，否则会导致依赖冲突。建议使用ls /etc/apt/sources.list.d/检查所有源文件。

误区2：忽略Python版本兼容性
ROS2 Humble要求Python 3.10+。若你的系统默认Python版本过低，使用python3 --version检查。切勿手动切换系统默认Python版本，这会导致apt包管理器崩溃。正确做法是使用virtualenv或conda管理Python环境。

误区3：bashrc中source顺序错误
若你同时安装了ROS1和ROS2，在~/.bashrc中必须确保ROS2的source语句在ROS1之后，且不能重复source。错误的顺序会导致ros2命令指向ROS1的Python脚本，报出ModuleNotFoundError。

复盘：一次典型的安装失败排查过程

# 现象：运行ros2 run时提示"Package not found"
# 排查步骤：
# 1. 检查环境变量
printenv | grep ROS
# 输出为空 → 说明setup.bash未加载

# 2. 手动source后测试
source /opt/ros/humble/setup.bash
ros2 run demo_nodes_cpp talker
# 正常运行 → 确认是bashrc配置问题

# 3. 修复bashrc
echo "source /opt/ros/humble/setup.bash" >> ~/.bashrc
source ~/.bashrc

# 4. 验证修复
ros2 pkg list | grep demo_nodes
# 输出demo_nodes_cpp和demo_nodes_py