2. 环境搭建

ROS2作为新一代机器人操作系统框架，其底层通信机制、构建系统和工具链均围绕现代Linux环境设计。搭建一个稳定、可复现的开发环境，是后续所有机器人应用开发、仿真调试和算法部署的前提。本章将系统讲解从Ubuntu系统基础配置到ROS2发行版选型，再到完整安装流程、环境变量管理以及DDS中间件核心概念的完整链路，帮助读者建立一套科学、高效的环境搭建方法论。

上图展示了ROS2环境搭建的整体架构。从系统层到通信层，每一层都承担着不同的职责。Ubuntu系统配置是基础底座，ROS2发行版选择决定了API兼容性和长期维护策略，安装步骤是具体操作路径，环境变量设置则连接了系统与ROS2运行时，而DDS中间件则是ROS2分布式通信的神经中枢。下面我们将逐层深入，结合实际操作经验，给出可落地的配置方案。

2.1 Ubuntu系统配置：从版本选择到基础优化

核心原理：为什么Ubuntu是ROS2的首选平台

ROS2官方对操作系统的支持策略非常明确：优先支持当前LTS（长期支持）版本的Ubuntu。这并非偶然，而是基于以下技术考量：Ubuntu的APT包管理机制与ROS2的二进制分发体系高度契合；Ubuntu内核版本较新，对实时补丁（PREEMPT_RT）的支持更完善；同时Ubuntu社区庞大，遇到编译依赖或驱动问题时更容易找到解决方案。对于机器人开发者而言，选择Ubuntu意味着选择了最成熟的生态支持。

判断方法：如何选择Ubuntu版本

选择Ubuntu版本时，应遵循"ROS2发行版官方支持矩阵"原则。例如，ROS2 Humble对应Ubuntu 22.04（Jammy），ROS2 Iron对应Ubuntu 22.04，ROS2 Rolling则面向最新Ubuntu版本。建议优先选择LTS版本，因为其维护周期长达5年，且与ROS2 LTS发行版（如Humble）的搭配最为稳定。避免使用非LTS版本，否则可能面临依赖库版本冲突或安全更新中断的风险。

操作流程：Ubuntu系统基础配置清单

完成Ubuntu安装后，需要进行以下基础配置，以确保ROS2安装和后续开发顺利：

1. 更新软件源：将/etc/apt/sources.list替换为国内镜像源（如阿里云、清华源），大幅提升下载速度。
2. 系统更新：执行sudo apt update && sudo apt upgrade -y，确保系统包为最新状态。
3. 安装基础工具：包括build-essential、git、curl、wget、vim等。
4. 设置UTF-8编码：确保locale为en_US.UTF-8，避免ROS2日志输出乱码。
5. 配置用户权限：将当前用户加入dialout组，以便访问串口设备（如雷达、舵机控制板）。

# 设置locale
sudo apt update
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 apt源（以Humble为例）
sudo apt install -y software-properties-common
sudo add-apt-repository universe
sudo apt update

案例拆解：新购工控机环境初始化

假设你拿到一台预装Ubuntu 22.04的工控机（Intel i7，16GB RAM，512GB SSD），目标部署ROS2 Humble。初始现象是系统自带源下载速度极慢，且缺少编译工具。操作步骤：首先替换为清华源，然后执行系统更新，安装vim、git等工具。接着配置ROS2源并安装ros-humble-desktop。整个过程约30分钟，安装后运行ros2 run demo_nodes_cpp talker验证。复盘经验：SSD磁盘空间建议预留至少20GB给ROS2及其依赖，否则后续编译大型工作空间时可能磁盘不足。

2.2 ROS2发行版选择：理解版本生命周期与特性差异

核心原理：发行版命名与发布节奏

ROS2发行版采用字母序命名，每两年发布一个LTS版本（如Humble Hawksbill），非LTS版本每6个月发布一次。LTS版本维护3年，非LTS版本仅维护1年。选择发行版时，需考虑项目周期、硬件平台兼容性以及社区活跃度。例如，Humble（2022年5月）是目前最稳定的LTS版本，支持Ubuntu 22.04，适合生产环境；Iron Irwini（2023年5月）为非LTS版本，适合尝鲜新特性，但不建议用于长期项目。

判断方法：根据项目需求选择发行版

从上表可以看出，Humble的维护周期最长，且与Ubuntu 22.04 LTS完美匹配，是当前最稳妥的选择。如果项目需要长期稳定运行，建议锁定Humble版本，并固定Ubuntu 22.04.3版本，避免系统自动升级导致依赖库变化。

操作流程：安装ROS2 Humble完整步骤

以下以Humble为例，展示标准安装流程：

# 1. 设置软件源
sudo apt install -y curl gnupg lsb-release
sudo curl -sSL https://raw.githubusercontent.com/ros/rosdistro/master/ros.key -o /usr/share/keyrings/ros-archive-keyring.gpg
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

# 2. 安装ROS2
sudo apt update
sudo apt install -y ros-humble-desktop python3-argcomplete

# 3. 安装开发工具
sudo apt install -y ros-dev-tools

# 4. 环境变量设置（临时生效）
source /opt/ros/humble/setup.bash

案例拆解：从源码编译与二进制安装的取舍

某实验室需要为定制传感器开发驱动，该传感器SDK依赖特定版本的Fast-DDS。二进制安装的ROS2 Humble默认使用Fast-DDS 2.6.x，而传感器SDK要求2.8.x。此时需要从源码编译ROS2或单独编译Fast-DDS并覆盖默认版本。实际操作中，我们选择在Docker容器中从源码编译ROS2 Humble，指定--cmake-args -DCMAKE_BUILD_TYPE=Release，编译耗时约2小时。结果证明，源码编译虽然耗时，但灵活性极高，且能针对ARM架构（如Jetson）进行优化。复盘经验：除非有特殊依赖需求，否则优先使用二进制安装，节省时间且易于维护。

2.3 环境变量设置：理解source机制与Overlay工作空间

核心原理：环境变量的作用域与优先级

ROS2的环境变量设置核心是setup.bash脚本。该脚本会设置ROS_DISTRO、AMENT_PREFIX_PATH、LD_LIBRARY_PATH、PYTHONPATH等关键变量。其中AMENT_PREFIX_PATH决定了ROS2包的搜索路径，LD_LIBRARY_PATH决定了动态链接库的搜索路径。理解这些变量的作用域，是解决"找不到包"或"版本冲突"问题的关键。

判断方法：何时需要source不同层级的setup文件

ROS2采用"Underlay/Overlay"层级结构。系统安装的ROS2位于/opt/ros/humble，这是Underlay层；用户自己创建的工作空间（如~/ros2_ws）是Overlay层。每次打开新终端，需要先source Underlay的setup.bash，再source Overlay的setup.bash，这样Overlay中的包会覆盖Underlay中的同名包。如果只source Overlay而不source Underlay，系统将无法找到ROS2核心库。

# 在~/.bashrc中添加以下内容，实现自动加载
echo "source /opt/ros/humble/setup.bash" >> ~/.bashrc
echo "source ~/ros2_ws/install/setup.bash" >> ~/.bashrc
source ~/.bashrc

操作流程：验证环境变量是否生效

1. 执行echo $ROS_DISTRO，应输出humble。
2. 执行printenv | grep -i ros，查看所有ROS相关变量。
3. 执行ros2 pkg list，应列出大量已安装包。

案例拆解：多工作空间叠加的依赖管理

一个移动机器人项目包含三个工作空间：robot_core（基础驱动）、robot_nav（导航算法）、robot_app（应用层）。每个工作空间独立编译，但robot_app依赖前两者。在~/.bashrc中按顺序source三个工作空间的setup.bash，确保robot_app最后加载。这样，当robot_nav中的某个包更新后，只需重新编译该工作空间，无需重新编译robot_app。复盘经验：Overlay机制极大提升了大型项目的迭代效率，但需注意包名冲突问题，建议使用--symlink-install编译选项，使安装目录中的文件指向源码，便于调试。

2.4 DDS中间件基础：通信架构与选型

核心原理：DDS在ROS2中的角色

DDS（Data Distribution Service）是ROS2默认的中间件，负责节点间的数据传输、发现和QoS策略执行。与ROS1的TCPROS/UDPROS不同，DDS采用去中心化的架构，支持点对点、多播和广播通信，且内置了可靠性、历史数据缓存、分区等高级特性。ROS2通过RMW（ROS Middleware Interface）抽象层屏蔽了不同DDS实现的差异，使得开发者可以灵活切换底层DDS。

判断方法：如何选择DDS实现

选择DDS时，需考虑硬件资源、实时性要求、网络拓扑复杂度以及商业授权成本。对于教学和大多数科研项目，Fast-DDS已足够；对于无人机、MCU等资源受限平台，Cyclone-DDS是更优选择。

操作流程：切换DDS实现并验证

# 安装Cyclone-DDS
sudo apt install -y ros-humble-rmw-cyclonedds-cpp

# 设置环境变量切换RMW实现
export RMW_IMPLEMENTATION=rmw_cyclonedds_cpp

# 验证当前使用的DDS
ros2 doctor --report

案例拆解：多机通信中的DDS发现机制问题

两台机器人（IP分别为192.168.1.100和192.168.1.101）通过Wi-Fi连接，运行同一ROS2图，但无法互相发现节点。初始现象是ros2 node list只能看到本机节点。分析过程：首先检查防火墙，发现UFW未开放7402端口（DDS发现端口）；其次检查网络接口，发现两台机器不在同一子网（一台在192.168.1.x，另一台在192.168.2.x）。解决步骤：统一子网，开放UDP 7402端口，并设置ROS_DOMAIN_ID为相同值（如42）。结果：节点成功互相发现。复盘经验：DDS发现依赖多播，Wi-Fi路由器需开启多播转发，否则需配置CYCLONEDDS_URI指定对端IP列表。

2.5 常见误区与总结复盘

误区一：忽略系统级依赖

很多初学者直接安装ROS2，却忽略了python3-pip、numpy等Python依赖，导致后续编译功能包时出现ModuleNotFoundError。建议在安装ROS2后，立即执行pip3 install -U rosdep并初始化rosdep，用于自动解析依赖。

误区二：环境变量配置混乱

在~/.bashrc中重复source不同版本的setup.bash，会导致包版本错乱。建议只保留一个ROS2发行版的source语句，并使用# ROS2 Humble注释区分。

误区三：忽视DDS调优

默认的Fast-DDS配置在跨网段或高丢包率环境下性能不佳。建议根据实际网络环境调整QoS策略，例如将reliability设置为reliable，history设置为keep_last(10)，以平衡实时性和数据完整性。

总结复盘：环境搭建的黄金法则

• 版本锁定：记录Ubuntu版本、ROS2发行版、DDS实现及关键依赖版本，形成环境清单。
• 自动化脚本：编写setup_env.sh脚本，一键完成源配置、依赖安装和环境变量设置。
• 容器化隔离：使用Docker或LXD容器隔离不同项目的环境，避免相互污染。
• 验证先行：安装完成后，运行ros2 run demo_nodes_cpp talker和ros2 run demo_nodes_cpp listener验证通信是否正常。