ROS 2 机器人运行示例与 ros2 run 命令解析

鼠标左键点击 节点图 中的元素，会变成如下样式：

• 左侧的 /turtlesim 是 海龟模拟器 节点
• 右侧的/teleop_turtle 是 键盘控制节点，右侧节点 通过 话题 向 左侧节点发送了 控制命令 /turtle1/cmd_vel。

二、ros2 run 命令解析

1、设计理念

ros2 run 命令 是 ROS 2 命令行工具 中 用于启动 单个功能包 内 可执行文件节点 的核心子命令，其格式设计严格遵循 ROS 2" 功能包 - 可执行文件 - 参数分离 " 的设计理念。

ros2 run 分为基础格式 ( 仅启动可执行文件 ) 和完整格式 ( 含可执行文件参数 + ROS 层面参数 )，完整格式 覆盖所有场景。

ros2 run 的核心逻辑是" 定位功能包 -> 找到可执行文件 -> 启动并接入 ROS 2 通信 "，其格式设计的关键是分离 " 可执行文件自身参数 " 和 " ROS 层面参数 " ( 通过 --ros-args 分隔 )。

**掌握该格式的核心是：**明确必选部分的匹配规则、可选部分的顺序要求，以及参数解析的边界。

2、ros2 run 基础格式

ros2 run 基础格式 命令格式如下：

ros2 run <package_name><executable_name>

• **ros2 参数：**ROS 2 命令行入口，所有 ROS 2 终端操作的统一前缀 ( 加载 ROS 2 核心工具链、DDS 通信层 )；
• **run 参数：**ros2 的子命令，功能是：
  • 查找功能包： 查找系统 / 本地 工作空间 中已安装的 <package_name>；
  • 定位可执行： 定位该功能包 内 编译生成的 <executable_name>；
  • ***启动执行：***启动该 可执行文件，并自动接入 ROS 2 通信系统 ( 成为 ROS 2 节点 )；
• **<package_name> 参数：**功能包名称；
  • 功能包来源： 已通过 colcon build 编译 ( 本地工作空间 ) 或 apt install 安装 ( 系统级 )；
  • 命名规范： 遵循 ROS 2 命名规范 ( 小写字母 + 下划线，如 turtlesim、my_robot_pkg)；
• **<executable_name> 参数：**是 功能包下 的 编译生成 的 可执行文件 名称；
  • 配置位置： 是 CMakeLists.txt/setup.py 中声明的 可执行目标名；

3、ros2 run 完整格式

ros2 run 完整格式 命令格式如下：

ros2 run <package_name><executable_name>[executable_args...][--ros-args <ros_args...>]

• **<> 符号：**表示 该参数 是必选参数，需替换为实际值，最终 不保留尖括号；
• **[] 符号：**表示 该参数 是可选参数，可省略；
• **... 符号：**表示 该参数 是可重复参数，多个值用空格分隔；
• **[executable_args...] 参数：**该参数 是传给可执行文件自身的参数，非 ROS 层面参数，由 可执行文件 的 代码解析，ROS 2 CLI 不处理，一般都是 自定义节点的配置文件路径、阈值、模式等；
• **[--ros-args <ros_args...>] 参数：**该参数 是 ROS 2 层面的参数配置 ( 核心分隔符)，--ros-args 之后的所有参数均由 ROS 2 核心解析，而非传给可执行文件；常用子参数如下：
  • --remap 参数：重映射 ( 节点名、命名空间、话题 / 服务名)；
  • --log-level 参数：设置日志等级 ( DEBUG/INFO/WARN/ERROR/FATAL)；
  • --param 参数：设置节点参数 ( 需节点支持)；
  • --env 参数：设置节点运行的环境变量；

4、启动海龟仿真器命令分析

以启动 海龟模拟器 的 命令参数 为例 进行分析：

ros2 run turtlesim turtlesim_node 

• **ros2 参数：**是 ROS 2 核心命令行入口，所有 ROS 2 终端操作均以该关键词开头 ( 如 ros2 node/ros2 topic)；
• **run 参数：**是 ros2 的子命令，功能是 从指定功能包中找到并运行对应的可执行文件 ( 本质是启动一个 ROS 2 节点)；
• **turtlesim 参数：**是 功能包名称 ( package name)，turtlesim 是 ROS 2 内置的示例功能包，封装了海龟仿真器的所有代码 ( 包括节点、话题、服务、动作等逻辑)；
• **turtlesim_node 参数：**是 可执行文件名称 ( executable name)，turtlesim 功能包中编译生成的可执行文件，运行后会启动海龟仿真器的核心节点。