ROS 2 实战：海龟仿真器与 ros2 run 命令详解

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 功能包中编译生成的可执行文件，运行后会启动海龟仿真器的核心节点；