从ROS1老鸟到ROS2新手：我踩过的那些‘兼容性’坑和高效迁移指南

最新推荐文章于 2026-05-17 06:32:56 发布

原创

最新推荐文章于 2026-05-17 06:32:56 发布 · 530 阅读

标签

#ROS2 #架构 #迁移指南

收录于

从ROS1老鸟到ROS2新手：我踩过的那些‘兼容性’坑和高效迁移指南

第一次在ROS2中运行那个本该简单的发布订阅demo时，终端里跳出的rclcpp未定义错误让我愣了三秒——这明明是在ROS1中跑过无数次的代码。作为有五年ROS1开发经验的"老鸟"，我低估了这两个版本间的鸿沟。本文将分享我在将一个基础ROS1包迁移到ROS2 Humble过程中遇到的真实问题，以及如何系统性地规避这些兼容性陷阱。

1. 包结构：从catkin到ament的思维转换

ROS1的catkin构建系统在ROS2中被ament取代，这种底层架构的变更直接影响着整个开发流程。迁移时第一个要重构的就是package.xml和CMakeLists.txt这两个核心文件。

1.1 package.xml的隐藏陷阱

ROS1中常见的<run_depend>标签在ROS2中已完全废弃，取而代之的是更简洁的<depend>统一管理所有依赖。但更易被忽视的是<export>标签的变化：

<!-- ROS1典型配置 -->
<export>
  <nodelet plugin="${prefix}/nodelets.xml" />
</export>

<!-- ROS2正确配置 -->
<export>
  <build_type>ament_cmake</build_type>
</export>

特别注意：ROS2强制要求声明构建工具类型，否则会导致colcon build失败。我在首次迁移时花了半小时才定位到这个看似简单的配置项。