【ROS2小白入门】从 ROS 1 到 ROS 2 的跨越：实战重构机器人底盘 Manager 节点

文章目录一、 构建系统的蜕变CMakeLists.txt 的优雅转身1. 告别 target_link_libraries 避坑指南 1找不到 serial 串口库二、 C 源码大换血彻底消灭 NodeHandle三、 通信机制迁移发布、订阅与异步服务1. 话题发布与订阅使用 std::bind2. 服务端与客户端拥抱异步四、 参数加载与多线程现代 C 的胜利1. 极简的参数加载2. 拥抱 std::thread五、 自定义消息与 Conda 环境的“血泪史” 避坑指南 2头文件“蛇形命名法”强制规定 避坑指南 3ModuleNotFoundError: No module named em结语在机器人底盘开发中Manager大管家节点通常充当着“大脑”的角色负责统筹底层硬件如 BMS 电池管理系统、驱动板并与上层算法导航、视觉进行交互。很多小伙伴在将原有的 ROS 1 机器人项目迁移到 ROS 2Humble时面对满屏的编译报错往往感到无从下手。今天我们就以一个真实的底盘 Manager 节点为例手把手带你完成从 ROS 1 到 ROS 2 的 C 代码重构并盘点那些让人抓狂的“暗坑”一、 构建系统的蜕变CMakeLists.txt的优雅转身在 ROS 2 中构建系统从catkin全面拥抱了ament_cmake。摒弃了过去繁琐的链接宏ROS 2 提供了极其优雅的依赖绑定方式。1. 告别target_link_libraries在 ROS 1 中我们需要手动链接一大堆库。而在 ROS 2 中只要用find_package找到了依赖最后用一个专属宏ament_target_dependencies就能将头文件和库一并绑定给可执行文件# 声明要编译的节点 add_executable(chassis_manager_node src/chassis_manager_node.cpp) # 核心新增将找到的依赖项全部链接到你的节点上 ament_target_dependencies(chassis_manager_node rclcpp std_msgs sensor_msgs nav_msgs my_robot_msgs # 你的自定义消息包 ) 避坑指南 1找不到serial串口库在 ROS 1 时代标配的serial库在 ROS 2 的官方 apt 软件源里并没有直接提供。如果直接#include serial/serial.h编译会直接罢工。解法去 GitHub 克隆开源社区维护的 ROS 2 兼容版serial库如joshnewans/serial到你的工作空间src目录下一起colcon build即可完美反杀二、 C 源码大换血彻底消灭NodeHandleROS 2 的核心理念是全面面向对象。在头文件中出场率极高的ros::NodeHandle必须全部替换为智能指针。重构对比ROS 1:ChassisManager(ros::NodeHandle nh);ROS 2:ChassisManager(rclcpp::Node::SharedPtr node);同时我们在类成员中保存这个node_指针后续所有的日志打印、参数获取全靠它// 日志打印的变迁// 旧ROS_ERROR(Error: %s, e.what());// 新RCLCPP_ERROR(node_-get_logger(),Error: %s,e.what());三、 通信机制迁移发布、订阅与异步服务这是迁移中最耗费体力但也最能体现 ROS 2 架构优势的部分。1. 话题发布与订阅使用std::bind由于回调函数是类成员函数在 ROS 2 创建订阅者时必须使用std::bind显式绑定this指针// 发布者是指针发布时需要用 - 操作符battery_pub_node_-create_publishersensor_msgs::msg::BatteryState(/battery_state,1);battery_pub_-publish(msg);// 订阅者需要显式绑定switch_sub_node_-create_subscriptionmy_robot_msgs::msg::SwitchState(/switch_state,1,std::bind(ChassisManager::switchCallback,this,std::placeholders::_1));(注ROS 2 废弃了latchtrue参数如果需要锁存话题需配置 QoS 的transient_local()策略。)2. 服务端与客户端拥抱异步在 ROS 1 中client.call(req)是阻塞的容易导致主线程卡死。在 ROS 2 多线程环境下我们推荐使用异步调用加.get()阻塞等待的优雅写法// 异步发送请求并阻塞等待结果autocancel_goal_reqstd::make_sharedmy_robot_srvs::srv::CancelGoal::Request();if(cancel_goal_srv_client_-wait_for_service(std::chrono::seconds(2))){cancel_goal_srv_client_-async_send_request(cancel_goal_req).get();RCLCPP_INFO(node_-get_logger(),Navigation goal canceled!);}四、 参数加载与多线程现代 C 的胜利1. 极简的参数加载在 ROS 2 中读取参数必须先声明。而且 ROS 2 原生支持读取数组再也不用像 ROS 1 那样写几十行繁琐的XmlRpc解析代码了// 一行代码搞定字符串数组加载极其优雅ultrasonic_param_.topicsnode_-declare_parameterstd::vectorstd::string(ultrasonic.topics,std::vectorstd::string());2. 拥抱std::thread摒弃臃肿的boost::thread和boost::mutex全面使用 C11/14 标准库的std::thread和std::mutex。致命提醒使用std::thread时必须在析构函数里调用.join()回收线程否则节点退出时整个程序会直接崩溃引发 coredump五、 自定义消息与 Conda 环境的“血泪史”在迁移自定义消息.msg和.srv时我们很容易踩到本次重构中最经典的两个坑 避坑指南 2头文件“蛇形命名法”强制规定在 ROS 1 中消息头文件是大驼峰命名例如#include sensor_msgs/Range.h。但在 ROS 2 中生成器会强制将其全部转为全小写的蛇形命名snake_case加.hpp后缀如果你写成#include sensor_msgs/msg/Range.hpp或者#include my_robot_msgs/msg/SwitchState.hpp编译器会直接报错找不到文件。正确写法#includesensor_msgs/msg/range.hpp#includemy_robot_msgs/msg/switch_state.hpp心法只要是msg或srv的头文件统统全小写加下划线 避坑指南 3ModuleNotFoundError: No module named em在执行colcon build编译自定义消息包时如果突然爆出找不到em或empy的 Python 错误请立刻检查你的终端是否激活了 Anaconda 环境带有(base)前缀CMake 会错误地调用 Conda 环境的 Python 去编译 ROS 2 的接口文件从而导致依赖缺失。解法敲击conda deactivate退出虚拟环境删除工作空间下的build和install文件夹再重新编译即可顺利通关结语从 ROS 1 到 ROS 2 的代码迁移本质上是从旧有的 C98/03 思维向现代 C11/14/17 架构体系的全面进化。虽然在这个过程中我们需要处理命名空间变动、智能指针替换等大量“体力活”但当你看到colcon build最终输出Finished的那一刻你会发现这一切的重构都是值得的你的底盘系统已经在 ROS 2 下焕发新生了