4. 命令行工具

ROS2 的命令行工具（CLI）是开发者与系统交互的第一入口，也是调试、验证和运维机器人应用的核心手段。与 ROS1 相比，ROS2 的 CLI 在命名空间、类型检查、发现机制和跨机通信方面做了大量重构。本章将围绕 ros2 node、ros2 topic、ros2 service、ros2 action、ros2 param 和 ros2 launch 六大命令族展开实战讲解，帮助你在真实工程中快速定位问题、验证通信链路并理解系统运行状态。

上图展示了 ROS2 六大 CLI 命令族的整体关系。它们并非孤立存在，而是围绕节点（Node）这一核心实体展开：节点通过话题（Topic）进行异步通信，通过服务（Service）完成同步调用，通过动作（Action）处理长时任务，通过参数（Parameter）实现运行时配置，而启动文件（Launch）则负责将上述所有元素按需编排。理解这张图，你就掌握了 ROS2 调试的全局视角。

4.1 ros2 node：节点生命周期与状态管理

核心原理

在 ROS2 中，节点是计算图的基本执行单元。每个节点负责特定的功能模块，例如传感器驱动、导航算法或运动控制。ros2 node 命令用于查询和管理这些节点的运行时状态。与 ROS1 不同，ROS2 节点默认支持多节点共处于同一进程（通过 component 机制），因此节点列表的查询对于理解进程内通信尤为重要。

判断方法与操作流程

# 列出当前所有活跃节点
ros2 node list

# 查看节点详细信息（包括订阅/发布的话题、服务、动作等）
ros2 node info /turtlesim

# 查看节点参数列表
ros2 node list --include-hidden-nodes  # 包含隐藏节点（如 /_ros2cli）

当系统中有多个机器人或复杂应用时，建议使用 --no-daemon 选项避免守护进程缓存干扰，确保获取实时状态。

命令选项	功能说明	典型场景
list	列出所有活跃节点	确认节点是否正常启动
info <node_name>	显示节点完整通信接口	排查节点是否订阅/发布了预期话题
--include-hidden-nodes	显示内部隐藏节点	调试 CLI 自身或特殊组件

实战场景：多节点系统状态确认

假设你启动了一个机器人仿真环境，包含 /turtle1 和 /teleop_turtle 两个节点。执行 ros2 node list 后，如果只看到 /teleop_turtle 而缺少 /turtle1，说明 turtlesim 节点可能崩溃或未正确加载。此时使用 ros2 node info /teleop_turtle 查看其发布的话题，若发现 /turtle1/cmd_vel 没有对应的订阅者，即可判断是 turtlesim 节点异常，而非通信故障。

4.2 ros2 topic：异步数据流的诊断利器

核心原理

话题是 ROS2 中最核心的异步通信机制，采用发布/订阅模式。数据在话题上以消息（Message）形式流动，消息类型由接口定义（.msg 文件）决定。ros2 topic 命令不仅用于查看话题列表，更重要的是用于验证数据内容、频率和 QoS 匹配情况。

操作流程与判断方法

# 列出所有话题
ros2 topic list

# 查看话题的详细信息（类型、发布者、订阅者、QoS）
ros2 topic info /turtle1/cmd_vel

# 实时监听话题数据（默认以 YAML 格式打印）
ros2 topic echo /turtle1/cmd_vel

# 查看话题发布频率
ros2 topic hz /turtle1/pose

# 手动发布数据（用于测试）
ros2 topic pub /turtle1/cmd_vel geometry_msgs/msg/Twist "{linear: {x: 2.0}, angular: {z: 1.0}}" --once

在调试时，ros2 topic hz 是判断数据流是否健康的关键指标。如果期望 10Hz 的激光雷达数据实际只有 2Hz，说明上游处理存在瓶颈或丢帧。

命令	核心用途	关键参数
echo	打印消息内容	--field 只显示特定字段；--qos-profile 指定 QoS
hz	统计消息频率	--window 设置统计窗口大小
pub	手动发布测试消息	--rate 设置发布频率；--once 只发一次
info	查看话题元数据	--verbose 显示详细 QoS 信息

案例拆解：QoS 不匹配导致的数据丢失

某移动机器人项目中，导航节点订阅了激光雷达话题 /scan，但始终收不到数据。使用 ros2 topic info /scan --verbose 发现发布者使用 QoS 为 Reliable，而订阅者使用 Best Effort。虽然 ROS2 允许这种组合，但实际通信中 Best Effort 会丢弃部分数据包。最终通过修改订阅者的 QoS 为 Reliable 解决了问题。这个案例说明，ros2 topic info 的 --verbose 选项是排查通信质量问题的第一把钥匙。

4.3 ros2 service：同步请求/响应调试

核心原理

服务用于同步的请求-响应通信，适合一次性调用，例如获取地图、保存参数或触发拍照。服务由客户端（Client）发起请求，服务端（Server）处理并返回响应。与话题不同，服务是瞬时的，不涉及持续的数据流。

操作流程

# 列出所有服务
ros2 service list

# 查看服务类型
ros2 service type /spawn

# 调用服务（传入 YAML 格式参数）
ros2 service call /spawn turtlesim/srv/Spawn "{x: 2.0, y: 2.0, theta: 0.2}"

# 查看服务接口定义
ros2 interface show turtlesim/srv/Spawn

在调用服务时，务必先使用 ros2 interface show 确认请求和响应的字段结构，避免因参数格式错误导致调用失败。

命令	功能	注意事项
list	列出所有服务	可使用 -t 同时显示类型
call	调用服务	参数必须符合 YAML 语法，且类型严格匹配
type	查询服务类型	用于确认接口定义

实战场景：动态生成机器人

在 turtlesim 仿真中，通过 ros2 service call /spawn 可以动态生成新乌龟。如果调用后没有反应，首先检查服务是否在线（ros2 service list），然后确认参数类型是否正确。例如 theta 字段是浮点数，如果误传整数，虽然 YAML 解析可能通过，但服务端可能拒绝处理。

4.4 ros2 action：长时任务的监控与反馈

核心原理

动作（Action）专为长时任务设计，例如导航到目标点、机械臂执行轨迹。它由目标（Goal）、反馈（Feedback）和结果（Result）三部分组成，支持取消和暂停。动作通信建立在话题和服务之上，但提供了更丰富的状态管理。

操作流程

# 列出所有动作
ros2 action list

# 查看动作类型
ros2 action type /turtle1/rotate_absolute

# 发送动作目标
ros2 action send_goal /turtle1/rotate_absolute turtlesim/action/RotateAbsolute "{theta: 1.57}"

# 发送目标并持续查看反馈
ros2 action send_goal /turtle1/rotate_absolute turtlesim/action/RotateAbsolute "{theta: 3.14}" --feedback

动作的调试重点在于反馈机制。通过 --feedback 选项，你可以实时观察任务执行进度，判断是否卡住或偏离预期。

命令	功能	关键选项
list	列出所有动作	-t 显示类型
send_goal	发送目标	--feedback 打印反馈；--wait 等待结果
cancel	取消动作	需要指定目标 ID

案例拆解：导航任务卡死排查

在机器人导航中，发送目标后机器人不动。使用 ros2 action send_goal /navigate_to_pose ... --feedback 发现反馈一直停留在 0.0，说明路径规划器没有产生有效路径。进一步检查 /map 话题的 hz，发现地图数据频率正常，但 /plan 话题没有数据。最终定位为全局规划器参数配置错误。这个案例展示了动作反馈在问题定位中的关键作用——它告诉你“卡在哪一步”，而不是“为什么卡”。

4.5 ros2 param：运行时配置与动态调参

核心原理

参数（Parameter）是节点的运行时配置项，可以是整数、浮点、字符串、布尔值或数组。ROS2 参数系统支持动态更新，节点可以监听参数变化并实时调整行为。这在 PID 调参、传感器阈值调整等场景中非常实用。

操作流程

# 列出节点所有参数
ros2 param list /turtlesim

# 获取参数值
ros2 param get /turtlesim background_r

# 设置参数值
ros2 param set /turtlesim background_r 150

# 保存参数到文件
ros2 param dump /turtlesim

# 从文件加载参数
ros2 param load /turtlesim params.yaml

参数操作的核心在于理解参数的作用域。参数属于特定节点，不同节点可以有同名参数但互不影响。

命令	功能	典型应用
list	列出参数名	确认节点有哪些可调参数
get	获取参数值	查看当前配置
set	设置参数值	动态调整 PID 或阈值
dump/load	参数持久化	保存/恢复配置

实战场景：动态调整背景颜色

在 turtlesim 中，通过 ros2 param set /turtlesim background_r 200 可以实时改变窗口背景色。这个操作无需重启节点，验证了参数动态更新的能力。在真实机器人中，你可以通过类似方式调整导航的代价地图膨胀半径，而无需重新编译或重启。

4.6 ros2 launch：多节点编排与参数注入

核心原理

启动文件（Launch）用于一次性启动多个节点、设置参数、加载命名空间，并处理节点间的依赖关系。ROS2 的 Launch 系统基于 Python，支持条件判断、变量替换和事件处理，比 ROS1 的 XML 更灵活。

操作流程

# 运行启动文件
ros2 launch turtlesim multisim.launch.py

# 查看启动文件内容（Python 格式）
cat /opt/ros/humble/share/turtlesim/launch/multisim.launch.py

# 调试启动文件（打印执行过程）
ros2 launch --show-args turtlesim multisim.launch.py

Launch 文件的核心价值在于“声明式”地描述系统拓扑。你可以通过 --show-args 查看可配置参数，通过 --debug 选项输出详细日志。

功能	实现方式	优势
多节点启动	Node() 动作	统一管理生命周期
参数注入	parameters=[{'key': 'value'}]	避免硬编码
条件逻辑	IfCondition/UnlessCondition	按需启动节点
事件处理	RegisterEventHandler	响应节点退出等事件

案例拆解：多机器人仿真启动

假设你需要启动两个 turtlesim 节点，分别命名为 t1 和 t2，并设置不同的背景色。Launch 文件可以这样写：

from launch import LaunchDescription
from launch_ros.actions import Node

def generate_launch_description():
    return LaunchDescription([
        Node(package='turtlesim', executable='turtlesim_node', name='t1',
             parameters=[{'background_r': 200}]),
        Node(package='turtlesim', executable='turtlesim_node', name='t2',
             parameters=[{'background_r': 50}]),
    ])

执行 ros2 launch my_launch.py 后，两个节点同时启动，且参数自动注入。如果其中一个节点启动失败，Launch 系统会记录错误并继续运行其他节点，这有助于隔离故障。

总结与复盘

本章的六大 CLI 命令构成了 ROS2 调试的完整工具箱。在实际工程中，建议遵循以下排查路径：先用 ros2 node list 确认节点在线，再用 ros2 topic list 和 ros2 topic hz 验证数据流，接着用 ros2 service list 和 ros2 action list 检查同步/异步接口，最后用 ros2 param get 确认配置。这种“从节点到数据，从数据到接口，从接口到配置”的递进式排查法，能帮助你快速定位 80% 以上的通信问题。

掌握这些命令，你不仅能够高效调试现有系统，还能在设计新节点时更清晰地规划通信接口。下一阶段，建议你结合具体的机器人应用（如导航、机械臂控制），反复练习这些命令的组合使用，直到形成肌肉记忆。