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

二、ros2 run 命令解析

在实际开发中，ros2 run 是最常用的启动命令之一。理解它的格式对于后续调试至关重要。

1. 设计理念

ros2 run 的设计遵循'功能包 - 可执行文件 - 参数分离'的原则。它主要分为基础格式和完整格式两种：

• 基础格式：仅用于启动简单的可执行文件。
• 完整格式：支持传递可执行文件自身的参数以及 ROS 层面的参数（如重映射、日志级别等）。

核心逻辑很简单：定位功能包 -> 找到可执行文件 -> 启动并接入 ROS 2 通信系统。

2. ros2 run 基础格式

最基础的用法如下：

ros2 run <package_name> <executable_name>

• ros2：命令行入口，加载核心工具链。
• run：子命令，表示从指定包中查找并运行可执行文件。
• <package_name>：功能包名称，例如 turtlesim。需确保已通过编译或安装。
• <executable_name>：功能包内编译生成的可执行文件名，通常在 CMakeLists.txt 中声明。

3. ros2 run 完整格式

当需要传递参数时，使用完整格式：

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

这里的符号含义如下：

• < >：必选参数，替换为实际值。
• [ ]：可选参数。
• ...：可重复参数。

关键点在于参数的分隔：

• [executable_args...]：传给可执行文件本身的参数，由代码内部解析（如配置文件路径、阈值等）。ROS 2 CLI 不会处理这些。
• [--ros-args <ros_args...>]：这是 ROS 2 层面的参数配置。注意，一旦遇到 --ros-args，后面的参数全部由 ROS 2 核心解析，不再传给程序本身。

常用 ROS 层面参数包括：

• --remap：重映射话题名、服务名或节点名。
• --log-level：设置日志等级（DEBUG/INFO/WARN 等）。
• --param：设置节点参数。
• --env：设置环境变量。

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

结合前面的例子，我们来拆解一下这条命令：

ros2 run turtlesim turtlesim_node

• ros2：核心入口。
• run：执行运行操作。
• turtlesim：功能包名，包含海龟仿真器的所有逻辑代码。
• turtlesim_node：可执行文件名，启动后会创建海龟仿真器的核心节点。

掌握这个命令的格式，基本就能应对 90% 以上的节点启动场景了。