4. ROS2开发环境配置
在STM32与ROS2通信开发的整体链路中，开发环境的质量直接决定了后续调试效率与项目可维护性。本章聚焦于ROS2开发环境的完整搭建流程，涵盖Ubuntu操作系统的安装要点、ROS2发行版的选择依据、colcon构建工具的核心机制，以及工作空间的创建与编译方法。我们将从底层系统开始，逐步构建一个稳定、可复现的ROS2开发环境，为后续STM32与ROS2的串口通信、话题订阅及自定义消息接口开发奠定坚实基础。
上图展示了从Ubuntu系统到ROS2发行版、colcon构建工具，再到工作空间四目录结构的完整链路。在后续内容中，我们将逐一拆解每个环节的关键决策点与操作细节，帮助读者建立系统化的环境配置思维。
4.1 Ubuntu安装：版本选择与分区策略
核心原理
Ubuntu作为ROS2官方支持的首选操作系统，其内核版本、glibc库和Python版本直接影响ROS2二进制包的兼容性。ROS2 Humble版本官方推荐Ubuntu 22.04 LTS（Jammy Jellyfish），该组合经过长期测试，稳定性最佳。Ubuntu LTS版本每两年发布一次，提供长达5年的安全更新，适合作为嵌入式开发的基础平台。
安装操作流程
- 镜像下载：从Ubuntu官网下载22.04.3 LTS桌面版ISO镜像，建议使用国内镜像源加速。
- 启动盘制作：使用Rufus（Windows）或balenaEtcher（跨平台）将ISO写入≥8GB的U盘。
- 分区方案：推荐手动分区，/（根分区）分配50GB以上，/home分配剩余空间，swap根据内存大小设置（内存≥16GB可省略）。
- 系统更新：安装完成后执行
sudo apt update && sudo apt upgrade -y确保系统处于最新状态。
案例拆解：虚拟机与物理机选择
某学员在VMware中安装Ubuntu 22.04进行ROS2学习，遇到串口无法识别STM32的问题。经排查，原因是虚拟机未将USB串口设备直通给客户机。解决方案：在虚拟机设置中添加USB控制器，并将USB设备连接方式改为“连接USB设备时自动连接到客户机”。若涉及实时性要求高的通信测试，建议直接使用物理机安装，避免虚拟化层带来的延迟抖动。
常见误区
- 盲目追求最新版本：Ubuntu 24.04虽然已发布，但ROS2 Humble官方不支持，强行安装需源码编译，增加环境复杂度。
- 忽略系统位数：必须安装64位系统，32位系统无法运行ROS2 Humble。
- 分区过小：ROS2编译过程中会产生大量中间文件，/分区不足会导致编译失败。
4.2 ROS2发行版选择：LTS优先原则
核心原理
ROS2发行版遵循固定节奏发布，每两年推出一个LTS（长期支持）版本，非LTS版本支持周期仅约6个月。选择LTS版本可确保在项目开发周期内获得持续的安全补丁和bug修复。当前主流LTS版本为Humble（2022年发布，支持至2027年），其对应Ubuntu 22.04，与STM32开发中常用的工具链兼容性最好。
| 发行版 | 发布时间 | 支持周期 | 对应Ubuntu | 适用场景 |
|---|---|---|---|---|
| Foxy | 2020.06 | 至2023.05 | 20.04 | 已过时，不推荐新项目 |
| Galactic | 2021.05 | 至2022.11 | 20.04 | 过渡版本，已停止维护 |
| Humble | 2022.05 | 至2027.05 | 22.04 | 当前推荐，长期稳定 |
| Iron | 2023.05 | 至2024.11 | 22.04 | 短期版本，适合尝鲜 |
| Jazzy | 2024.05 | 至2029.05 | 24.04 | 新一代LTS，生态待完善 |
选择判断方法
- 项目周期：若项目开发周期超过1年，必须选择LTS版本。
- 硬件兼容性：确认STM32相关工具链（如OpenOCD、STM32CubeProgrammer）在对应Ubuntu版本上的驱动支持。
- 社区生态：Humble拥有最丰富的第三方库和教程资源，遇到问题更容易找到解决方案。
4.3 colcon构建工具：核心机制与常用命令
核心原理
colcon是ROS2官方推荐的构建工具，替代了ROS1时代的catkin。其核心优势在于：支持多包并行编译、增量构建、依赖自动排序，以及灵活的构建选项。colcon将构建过程分为配置（configure）、编译（build）、安装（install）三个阶段，每个阶段均可独立执行和缓存。
操作流程
# 安装colcon
sudo apt install python3-colcon-common-extensions
# 构建工作空间（在包含src的目录下执行）
colcon build
# 常用参数
colcon build --packages-select stm32_bridge # 只编译指定包
colcon build --symlink-install # 符号链接安装，便于开发调试
colcon build --cmake-args -DCMAKE_BUILD_TYPE=Release # 传递CMake参数
colcon build --parallel-workers 4 # 指定并行任务数案例拆解：增量编译优化
某项目包含5个功能包，首次全量编译耗时约8分钟。在修改stm32_bridge包中的单个源文件后，直接执行 colcon build，colcon通过文件哈希检测到仅该包发生变化，只重新编译该包及其下游依赖，耗时缩短至40秒。若使用 --symlink-install 参数，Python脚本和launch文件无需重新安装即可生效，进一步加快迭代速度。
常见误区
- 混淆build与install目录：build存放中间产物，install存放最终可执行文件，运行时必须source install目录。
- 忽略依赖顺序：colcon自动处理包间依赖，但若手动指定
--packages-select时遗漏依赖包，会导致编译失败。 - 不清理旧构建：当CMakeLists.txt或package.xml发生重大变更时，应删除build目录重新构建，避免缓存冲突。
4.4 工作空间创建与编译：从零搭建完整流程
核心原理
ROS2工作空间采用Overlay机制，底层为系统安装的ROS2基础环境（Underlay），上层为开发者自定义的功能包（Overlay）。通过source install/setup.bash将Overlay叠加到当前环境，实现多工作空间共存与隔离。
操作流程
# 1. 创建目录结构
mkdir -p ~/ros2_ws/src
cd ~/ros2_ws
# 2. 创建功能包（以C++为例）
cd src
ros2 pkg create stm32_bridge --build-type ament_cmake --dependencies rclcpp std_msgs serial
# 3. 编写代码（此处省略具体实现）
# 4. 编译工作空间
cd ~/ros2_ws
colcon build --symlink-install
# 5. 加载环境
source install/setup.bash
# 6. 验证
ros2 pkg list | grep stm32_bridge案例拆解：完整编译排障过程
某学员在编译stm32_bridge包时出现以下错误：Could not find a package configuration file provided by "serial"。分析过程：该错误表示缺少serial库的CMake配置。排查步骤：①检查package.xml中是否声明serial依赖；②确认系统是否安装serial库（sudo apt install libserial-dev）；③检查CMakeLists.txt中find_package(serial REQUIRED)是否正确。最终定位为系统缺少libserial-dev，安装后重新编译成功。
| 错误类型 | 常见原因 | 解决方案 |
|---|---|---|
| 找不到包配置 | 依赖未安装或未声明 | 安装对应库，检查package.xml |
| 编译语法错误 | 代码问题或CMake版本不兼容 | 查看完整日志，定位具体文件行号 |
| 链接错误 | 库路径未正确传递 | 检查CMakeLists.txt中target_link_libraries |
| 环境未加载 | 未source setup.bash | 执行source install/setup.bash |
常见误区与复盘
- 每次新终端都要source：可将source命令写入~/.bashrc，但注意多个工作空间叠加时顺序会影响包解析优先级。
- 忽略编译日志：log目录下的latest_build目录包含完整日志，排障时优先查看。
- 不区分Debug与Release：调试阶段使用默认构建，性能测试时使用Release模式，两者不可混用。