【ROS2】 命令行工具速查手册从入门到日常调试必备在 ROS2 的开发与调试过程中命令行工具CLI是我们最常用的利器。与 ROS1 不同ROS2 将所有命令行工具统一整合到了ros2主命令及其子命令下这使得命令结构更加清晰、规范。为了方便大家在日常开发中快速查阅本文将 ROS2 常用命令按功能模块进行了分类整理建议收藏备用 一、 节点运行与工程启动这是日常开发中最基础的操作主要用于启动节点或整个机器人系统。ros2 run pkg node运行单个节点。ros2 launch pkg launch_file启动 Launch 文件一次性运行多个节点及配置参数。ros2 pkg executables pkg查看某个功能包下包含哪些可执行节点。 二、 系统状态查看与调试当系统出现通信异常或数据流问题时以下命令是你的“排查神器”。1. 节点管理 (Node)ros2 node list列出当前系统中所有活跃的节点。ros2 node info node_name查看某个节点的详细信息包括它订阅/发布的话题、提供/调用的服务及动作等。2. 话题通信 (Topic)ros2 topic list列出所有当前活跃的话题。进阶加上-t参数可同时显示消息类型ros2 topic echo topic_name实时打印话题中传输的消息内容调试传感器数据必备。ros2 topic hz topic_name查看话题消息的发布频率Hz。ros2 topic pub topic_name msg_type args手动向指定话题发布测试消息用于脱离代码进行硬件或算法测试。ros2 topic info topic_name查看话题的详细信息如发布者数量、订阅者数量及消息类型。3. 服务与动作 (Service Action)ros2 service list/ros2 action list列出当前系统中所有可用的服务或动作。ros2 service call service_name type args在命令行手动调用服务快速验证服务端逻辑。ros2 action send_goal action_name type args向动作服务器发送目标测试长耗时任务如导航、机械臂抓取。⚙️ 三、 参数配置 (Parameters)ROS2 引入了强大的动态参数系统允许在运行时查看或修改节点的配置。ros2 param list node_name查看指定节点声明的所有参数。ros2 param get node_name param_name获取某个参数的当前运行值。ros2 param set node_name param_name value动态设置或修改参数值无需重启节点。ros2 param dump node_name将节点当前的所有参数导出通常重定向保存为 YAML 文件方便后续复用配置。 四、 数据记录与回放 (Bag)用于录制传感器数据进行离线分析、算法回放测试或问题复现。ros2 bag record topic_name录制指定话题的数据。进阶加上-a参数可录制系统中所有话题ros2 bag play bag_file回放录制好的数据包。ros2 bag info bag_file查看数据包包含的话题列表、消息数量和录制时长等元信息。️ 五、 接口与环境诊断ros2 interface show msg_type查看消息、服务或动作的具体字段结构。例如ros2 interface show geometry_msgs/msg/Twist。ros2 doctor一键检查 ROS2 环境配置、网络连通性和底层 DDS 是否存在潜在问题是解决“节点互相找不到”等玄学问题的第一步。 实用小贴士忘记命令怎么办如果你忘记了某个命令的具体用法或参数可以在任何命令后加上-h参数。例如ros2 topic -h或ros2 topic echo -h系统会输出详细的帮助文档和参数说明。 总结熟练掌握以上 ROS2 命令行工具能够极大地提升你的开发效率与问题排查速度。建议在日常开发中多使用ros2 topic echo和ros2 node info来验证数据流和节点状态。如果这篇速查手册对你有帮助欢迎点赞、收藏、关注后续将持续更新 ROS2 开发实战技巧。