从 ROS1 切到 ROS2 的朋友最开始最不适应的就是指令以前rostopic echo、rosrun、catkin_make用得很顺手到了 ROS2 全变成了ros2 topic echo、ros2 run、colcon build看着相似细节上坑却不少。我最近几轮项目都是基于 ROS2 Humble 在做这篇文章把日常开发里真正高频的 ROS2 指令按场景重新整理了一遍从环境加载、工作区编译到节点、话题、服务、动作、参数、bag、tf 这些核心操作每一条都是可直接复制去用的实际命令。文章末尾放了一份 ROS1 与 ROS2 指令对照表方便还在双版本切换的人快速定位差异。不管你是刚装好 ROS2 准备跑小乌龟试手还是已经在 Ubuntu 22.04 Humble 下写自己的功能包这篇文章的目标就是帮你把“输入命令”这件事变得和喝水一样自然。命令背后的原理我也会随手解释几句毕竟光会敲不知道什么时候用遇到报错还是会懵。1. 环境准备与工作区构建开干之前先把命令搞明白1.1 source 环境不同版本的加载路径别混用ROS2 安装完第一件事就是加载环境以 Humble 为例常规写法是source /opt/ros/humble/setup.bash这行命令的本质是把 ROS2 的安装路径、可执行文件、Python 模块、共享库等一系列路径注入当前终端。只要终端重新打开这些环境变量就会丢失所以很多人会在~/.bashrc里追加这行省得每次手动敲。但我个人建议先不要急着往.bashrc里写因为在同一个终端里 source 过多个版本容易出问题。举一个很典型的场景你装了 ROS2 Humble但系统里还残留了旧版本 ROS1 Noetic 的source /opt/ros/noetic/setup.bash两个环境一叠加ros2命令可能找不到或者出现 Python 包冲突。稳妥的做法是区分终端一个终端专门用 ROS1一个终端专门用 ROS2需要切换的时候直接新开窗口不混用。另一个细节是setup.bash本身也有讲究。ROS2 的发行包官方推荐source /opt/ros/distro/setup.bash其中distro对应发行版名称比如foxy、galactic、humble、jazzy。Ubuntu 22.04 装 Humble、Ubuntu 24.04 装 Jazzy这个路径名一定要对应好。看到ROS_DISTRO环境变量为空或者不对第一时间检查 source 的路径到底是不是你实际安装的版本。提示如果你同时装了多个 ROS2 版本比如 Humble 和 Jazzy建议每个工作区开独立的终端不要在同一条 shell 里来回 source。环境变量一旦混了很难一次性清干净。1.2 colcon 构建从编译到环境刷新的完整链路ROS1 时代catkin_make几乎是标配ROS2 官方推荐改用colcon。这个工具对多包工作区的处理更加规范支持并行编译、增量编译也能更清晰地分离build、install、log三个目录。整体流程是cd ~/ros2_ws colcon build如果只想编译某个包可以加--packages-select参数colcon build --packages-select my_package这个参数非常实用。工作区里包一多全量编译浪费时间只编译自己正在改的包效率高很多。同时还有--symlink-install参数它让 Python 脚本和 launch 文件以软链接方式安装到install目录这样你改了 Python 源码不用重新编译重启节点就能生效。做纯 Python 节点开发时我基本必加这个参数colcon build --symlink-install --packages-select my_package编译完成之后最容易被新手跳过的一步是“刷新环境”。编译产物生成在install目录但当前终端并不知道这些包的存在必须手动 sourcesource install/setup.bash这一步和 ROS1 的source devel/setup.bash逻辑完全一致只是目录名从devel变成了install。很多人编译完直接运行ros2 run my_package my_node结果提示Package my_package not found九成是忘记 source install 了。关于是否每个终端都要 sourceinstall/setup.bash我的习惯是基础环境/opt/ros/humble/setup.bash写进.bashrc工作区环境手动在每个终端里 source或者也写进.bashrc但用一行注释标明是哪工作区。这样终端启动时自动能运行工作区里的包适合单人开发环境。1.3 包创建与信息查询pkg、interface 类命令ROS2 创建功能包的命令是ros2 pkg create my_package --build-type ament_cmake还可以指定依赖、节点名比如ros2 pkg create my_package --build-type ament_python --dependencies rclpy std_msgs常用的--build-type有三种ament_cmake用于 C 包ament_python用于 Python 包ament_cmake_python用于混合包。我自己的选择标准很简单以 C 为主或需要性能就用ament_cmake纯业务逻辑和快速验证用ament_python。查看当前有哪些包、某个包装在哪个路径也常用这两个命令ros2 pkg list ros2 pkg prefix turtlesimros2 pkg list输出的是环境里所有 ROS2 包的名单常用于确认某个包有没有被正确识别。ros2 pkg prefix用于查看包的安装前缀比如调试时想确认某个包是不是来自你自己的工作区执行后看输出路径是否包含/root/ros2_ws/install一眼就能判断。与自定义接口相关的还有一个高频命令系列ros2 interface。写了一组.msg、.srv、.action接口文件后通过ros2 interface list可以查看当前环境认识的所有接口ros2 interface show type可以查看接口的具体字段结构。改了接口文件以后一定要重新colcon build并 source否则新接口不会被识别。2. 五类通信操作节点、话题、服务、动作、参数通信是 ROS 的核心ROS2 不管是话题、服务还是动作指令结构都是ros2 类型 动词的形态。这个设计比 ROS1 更统一习惯之后查命令效率非常高。2.1 节点管理run、list、info 一条龙启动节点ros2 run package_name executable_name比如经典的小乌龟示例ros2 run turtlesim turtlesim_node ros2 run turtlesim turtle_teleop_key第一个指令启动仿真节点第二个启动键盘控制节点。注意executable_name是 CMake 里add_executable定义的可执行目标名不一定和包名相同文件树里对应的通常是src/executable.cpp。如果运行ros2 run提示找不到可执行文件检查一下是否 source 了正确环境或者用ros2 pkg prefix确认包路径。查看当前运行了哪些节点ros2 node list查看某个节点的详细信息包括订阅的话题、发布的话题、服务的客户端和服务器、动作客户端和服务器等ros2 node info /turtlesimnode info是我调试时的第一选择。当一个节点表现异常我会先看它的订阅和发布是否真的建立话题名有没有拼错。值得提醒的是ROS2 节点名前面要加/因为这是图命名空间里的绝对路径。不写前导斜杠时某些命令也能解析但最好养成写绝对路径的习惯。ROS2 的节点生命周期还有一个特性就是ros2 lifecycle系列命令。ros2 lifecycle get /node_name查看状态ros2 lifecycle set /node_name configure、activate等控制状态切换。这个在 Nav2 导航节点里很常见调生命周期状态时比直接杀进程重启精细得多。2.2 话题操作echo、hz、info 是调试三件套查看话题列表ros2 topic list想连消息类型一起看加-t参数ros2 topic list -t这个参数会显示每个话题对应的消息类型调试时特别有用能一眼看出话题类型是否匹配。输出大概是/cmd_vel [geometry_msgs/msg/Twist] /odom [nav_msgs/msg/Odometry]监听话题数据ros2 topic echo /turtle1/cmd_velecho订阅这个话题并持续打印数据流。如果只想看一两条就退出可以加--once参数来单次采样比如ros2 topic echo /turtle1/cmd_vel --once这个用法在检查某个消息是否按期望发出时非常方便不用一直挂着终端。查看话题实时频率ros2 topic hz /turtle1/posehz命令统计消息发布频率单位 Hz。导航、SLAM 这类对频率敏感的系统发布频率掉了往往意味着计算资源不足或消息队列阻塞。有段时间我做激光雷达数据接入ros2 topic hz /scan一直显示 5Hz 左右但雷达本身是 10Hz最后查出来是驱动节点处理不过来topic 里有大量消息积压加多线程回调后恢复正常。这类问题如果不用hz看频率光靠 log 还真不好定位。查看消息类型和发布订阅统计信息ros2 topic info /turtle1/pose --verboseinfo不带--verbose时只显示类型和发布订阅数量带--verbose后还会显示节点级计数的统计明细能看出究竟是哪个节点在发布、哪个节点在订阅。当系统里节点很多时info --verbose比list更容易排查“为什么这个 topic 没人订阅”这类连接问题。想往话题里主动塞一条数据用于测试可以这样发ros2 topic pub /turtle1/cmd_vel geometry_msgs/msg/Twist {linear: {x: 2.0, y: 0.0, z: 0.0}, angular: {z: 0.5}}这条命令会以 1Hz 默认频率持续发布消息。如果只想发一次加--once。用小乌龟验证时这条命令可以直接让乌龟走一个圆弧比单靠键盘控制更能说明话题发布是否正常。注意ROS2 的消息类型书写方式必须写全称比如geometry_msgs/msg/Twist不能像 ROS1 那样只写geometry_msgs/Twist。缺了中间的msg、srv、action的话命令会报类型不存在。2.3 服务与动作请求/响应模型和长期任务的选择ROS2 服务是同步请求/响应机制。列出当前所有服务ros2 service list查看某个服务的类型ros2 service type /spawn在 turtlesim 里/spawn用于生成新乌龟类型是turtlesim/srv/Spawn。调用这个服务ros2 service call /spawn turtlesim/srv/Spawn {x: 2.0, y: 2.0, theta: 0.5, name: turtle2}注意参数必须写成 YAML 花括号格式字符串要带引号。这条命令实际上是向服务端发送一个生成新乌龟请求返回时会给出新生成乌龟的名字。服务通信通常适合“请求-回答”一次性的操作比如拍照、设置参数、查询状态不适合长时间持续执行的任务。动作Action机制专门用于带反馈的长期任务ROS2 里也保留了完整的指令支持。查看动作列表和状态ros2 action list ros2 action list -t ros2 action info /turtle1/rotate_angle发送动作目标ros2 action send_goal /turtle1/rotate_angle turtlesim/action/RotateAngle {theta: 1.5}在导航场景中发送目标点就是典型的动作调用。send_goal默认会等待执行完成才结束加--feedback参数可以看到实时反馈。动作适合“执行时间长、中途要反馈进度、可以取消”的任务比如机器人走过去、转个角度、抓取物体。2.4 参数操作get、set、dump、load 四件套参数是节点运行时配置的重要手段。查看节点参数列表ros2 param list /turtlesim获取指定参数值ros2 param get /turtlesim background_r设置参数值ros2 param set /turtlesim background_r 150在 turtlesim 里把background_r改成 150 后仿真窗口背景色会立即变化。这说明了 ROS2 参数的一大特点支持动态更新。但这里有个前提参数是否能动态生效取决于节点作者有没有实现相应的 set 回调。如果节点没有做动态配置处理参数值虽然设置成功实际行为可能不会马上变化需要重启节点。批量导出和导入参数ros2 param dump /turtlesim ros2 param load /turtlesim params.yamldump会把当前节点的所有参数写入当前目录下的turtlesim.yaml默认文件名为节点名.yamlload可以把 YAML 文件里的参数批量加载。这个机制做系统调优时特别有用。以前我调 Nav2 的导航参数每次改完一堆参数就重启节点后来改成先把调好的参数dump到 YAML 文件重装或换机器后直接load省了很多重复操作。3. 工程效率工具launch、rosbag、tf 与可视化单个节点用ros2 run启动没问题但一个完整机器人系统往往有十几个节点驱动、SLAM、导航、可视化、状态估计手动一个个启动显然不现实。ROS2 里 launch 文件就是干这个的同时还有录包、tf 检查、图形化调试这些配套工具。3.1 launch 启动一个文件拉起整个系统启动 launch 文件的命令ros2 launch package_name launch_file_name比如导航仿真常见的ros2 launch nav2_bringup tb3_simulation_launch.pylaunch 文件通常是.py后缀使用 Python 编写取代了 ROS1 的.xml格式。为什么用 Python因为 launch 过程本身就是一段可以带逻辑的程序能做条件判断、参数替换、嵌套调用灵活度比 XML 高很多。在 launch 文件里可以动态传入参数比如设置使用仿真的地图、是否启动 RVizros2 launch nav2_bringup tb3_simulation_launch.py headless:False看到:这个赋值符号要习惯一下这是 ROS2 launch 传递参数的语法不是。初次从 ROS1 迁移的人经常在这里写错。自己写 launch 时我常用IncludeLaunchDescription来组合多个子 launch也常用Node实例来声明要启动的节点。一个最基本的 Python launch 文件骨架大概是from launch import LaunchDescription from launch_ros.actions import Node def generate_launch_description(): return LaunchDescription([ Node( packageturtlesim, executableturtlesim_node, namemy_turtle, outputscreen ) ])然后ros2 launch my_package my_launch.py这样就能用一个文件启动节点并统一设置节点名、命名空间、参数文件、remap 规则等。outputscreen的意思是让节点日志输出到终端不设置的话默认写到日志文件调试时不方便实时看。3.2 rosbag2 录包与回放数据采集的核心操作录包前先确认要录哪些话题。最粗暴的录法是全录ros2 bag record -a-a表示把所有话题都记录下来。这在做实验数据采集时很方便但也会带来巨大的磁盘占用。规范做法是只录自己关心的话题ros2 bag record /scan /odom /cmd_vel查询录好的包的信息ros2 bag info bag_directory_name回放数据ros2 bag play bag_directory_name回放时可以控制频率和循环ros2 bag play bag_directory_name --loop --rate 1.5--loop让数据循环播放做长时间测试时很省事--rate 1.5表示 1.5 倍速播放。录下来的包默认生成在当前目录下以时间戳命名的文件夹里面是metadata.yaml和若干.db3数据文件。.db3是 SQLite 格式也可以直接拿数据库工具打开但日常使用ros2 bag info和ros2 bag play就够了。提示录包前最好先ros2 topic list -t确认话题名和消息类型不要凭记忆敲话题名。话题拼错会导致录下来的包是空的折腾半天才发现是名字打错。3.3 tf、rviz2 与 rqt图形化调试组合机器人坐标变换是导航、机械臂、视觉融合的底层基础ROS2 里查看 tf 关系的命令有ros2 run tf2_ros tf2_echo map odom这会打印从map坐标系到odom坐标系的平移和旋转变换。如果两个坐标系之间没有建立连接命令会一直等待或报错。查看完整变换树ros2 run tf2_tools view_frames这条命令会生成一个frames.pdf文件里面是当前所有坐标系的父子关系树。当你在 RViz 里看到机器人零件乱飞、TF 报错时先view_frames看一下树结构确认是不是某个坐标系断链了比自己猜要快得多。RViz 是可视化利器rviz2我几乎每个项目都把 RViz 当成第一调试窗口。加激光、加地图、加路径、加机器人模型都可以用面板上的 Add 按钮完成。如果你在写导航相关的代码RViz 2D Pose Estimate、2D Goal Pose 按钮更是标准操作。rqt 系列同样实用。最常用的是rqt_graphrqt_graph把节点、话题、服务画成一张有向图。以前我在 ROS1 下排查通信问题就离不开它ROS2 里这个工具依然好用。当你怀疑“某个节点到底在不在订阅这个话题”时看rqt_graph比看代码更直接。还有一个常用的是rqt_console用于查看日志消息流过滤 Warning、Error 级别的日志很方便。3.4 daemon、doctor 与日志环境问题快速排查ROS2 引入了一个后台守护进程daemon它负责索引节点、主题等图信息让ros2 node list、ros2 topic list这些命令响应更快。但这个 daemon 有个经典副作用节点退出了但ros2 node list里可能还残留旧节点信息或者新节点迟迟不出现。遇到这种情况第一反应是重启 daemonros2 daemon stop ros2 daemon start甚至可以直接ros2 daemon stop之后下次执行命令时它会自动启动很多时候不用手动 start。环境整体体检ros2 doctorros2 doctor会检查环境变量、网络发现、系统依赖等问题并给出报告。它有几种模式比如ros2 doctor --report生成完整报告ros2 doctor --health-check检查系统健康状态。虽然它不一定能一次性定位到所有问题但当环境出现莫名其妙的问题时先跑一下doctor大概率能排除环境层面的干扰。ROS2 的日志系统也是排查线索的重要来源ros2 run my_package my_node --ros-args --log-level debug通过--log-level debug可以临时把节点日志级别调到 DEBUG看到比默认 INFO 更多的内部信息。注意--ros-args是 ROS2 参数传递的分隔符它后面的--log-level才属于 ROS 系统参数这种写法在ros2 run、ros2 launch里都适用。4. ROS1 与 ROS2 指令对照速查表4.1 核心指令对比总表下面这个对照表是我从 ROS1 Noetic 迁到 ROS2 Humble 时自己整理的。核心规律是ROS1 的rosxxx变成ros2 xxx动词基本不变但语法分隔有差异。功能说明ROS1 指令ROS2 指令加载环境source /opt/ros/noetic/setup.bashsource /opt/ros/humble/setup.bash启动核心节点roscore不需要自动发现机制编译工作区catkin_make或catkin buildcolcon build刷新工作区环境source devel/setup.bashsource install/setup.bash运行节点rosrun pkg noderos2 run pkg executable节点列表rosnode listros2 node list节点信息rosnode info /noderos2 node info /node话题列表rostopic listros2 topic list话题类型rostopic type /topicros2 topic type /topic监听话题rostopic echo /topicros2 topic echo /topic话题频率rostopic hz /topicros2 topic hz /topic发送话题数据rostopic pub /topic type dataros2 topic pub /topic type {data}服务列表rosservice listros2 service list服务类型rosservice type /svcros2 service type /svc调用服务rosservice call /svc type argsros2 service call /svc type {args}参数列表rosparam listros2 param list /node获取参数rosparam get /node/paramros2 param get /node param设置参数rosparam set /node/param valueros2 param set /node param value转储参数rosparam dump file.yamlros2 param dump /node加载参数rosparam load file.yamlros2 param load /node file.yaml录制 bagrosbag record -aros2 bag record -a播放 bagrosbag play bag.bagros2 bag play bag_dir查看 bag 信息rosbag info bag.bagros2 bag info bag_dir启动 launchroslaunch pkg file.launchros2 launch pkg file.launch.py创建包catkin_create_pkg pkg roscppros2 pkg create pkg --build-type ament_cmake消息类型geometry_msgs/Twistgeometry_msgs/msg/Twist服务类型turtlesim/Spawnturtlesim/srv/SpawnTF 查询rosrun tf tf_echo map odomros2 run tf2_ros tf2_echo map odom图形化节点图rqt_graphrqt_graph基本一致可视化rvizrviz2这张表里的细节差异看着多记住一条主线就顺了ROS2 把“资源类型”作为子命令的第二段。ROS1 是rostopic、rosservice、rosparam全部分开ROS2 是统一用ros2加类型词比如topic、service、param、action、bag、node。有了这个认知平时查命令不用死记硬背用ros2 tabtab都能列出来。4.2 迁移时最容易踩的三个思维差异第一ROS2 没有 roscore。ROS1 所有节点要通信必须先启动一个中心节点roscoreROS2 的节点之间通过 DDS 自动发现不用中心节点。习惯还在敲roscore的人会突然发现ROS2 下这个命令根本不存在节点之间只要在同一台机器、同一 DDS 域启动起来就能自动发现彼此。但这也带来一个新的注意点不同终端要保证ROS_DOMAIN_ID一致否则互相看不见。第二类型名多了中间层。ROS1 下写geometry_msgs/TwistROS2 必须写geometry_msgs/msg/Twist。服务类型从turtlesim/Spawn变成turtlesim/srv/Spawn。这个msg、srv、action的中间段是 ROS2 接口文件组织的直接体现消息、服务、动作的接口定义分别放在msg/、srv/、action/目录下。第三launch 文件变成 Python参数传递用:。ROS1 的 launch 文件是 XMLROS2 推荐用 Python 脚本。很多人从 ROS1 搬过来的第一个 launch 报错就是参数传递ROS1 里写arg:valueROS2 里要写arg:value少一对引号反而更容易出现语法混淆。5. 一条龙调试套路与常见问题速查5.1 我平时最顺手的调试链路拿到一个有问题的机器人系统我不会上来就改代码而是按固定顺序用命令快速扫描一遍系统状态。第一步ros2 node list确认该起来的节点都在。这一步经常能发现某个节点崩溃后自动退出或者由于依赖的 topic 没发布导致节点 waiting。第二步ros2 topic list -t看话题是否存在类型是否正常。第三步挑核心话题ros2 topic echo /scan --once看数据是否正常再用ros2 topic hz /scan看发布频率。第四步检查 Node 之间的连接情况使用rqt_graph看图形化连接。第五步如果涉及坐标变换执行view_frames看 tf 树。这套流程走下来大概 70% 的问题都能定位到方向。比如有一次机器人定位飘得厉害我先看ros2 topic hz /odom频率正常但ros2 topic echo /odom --once看到 z 轴角速度有异常跳变最后查出来是轮式编码器某个方向装反了。这类问题如果不借助echo和hz组合排查基本要抓瞎很久。5.2 常见问题速查表下面这些问题是新手群里出现频率最高的我把排查思路和解决办法一起列了出来。现象常见原因解决办法ros2: command not foundROS2 环境没 source或未安装确认安装路径source /opt/ros/humble/setup.bashPackage not found未 sourceinstall/setup.bash先colcon build再source install/setup.bashros2 node list里老节点消失不了daemon 缓存执行ros2 daemon stop必要时ros2 daemon start两个终端节点互相看不见ROS_DOMAIN_ID不一致统一export ROS_DOMAIN_ID同一个数字话题类型写不对少了中间msg、srv、action用ros2 interface list查全称运行节点后日志不显示没有设置outputscreenlaunch 文件里节点加outputscreenros2 bag play回放时话题发布不出来回放包里的消息类型和当前环境不匹配确认包是用相同消息定义录制的编译时找不到自定义消息依赖包未同步构建colcon build --packages-up-to my_package关于--packages-up-to多说一句。当你的包依赖了自己工作区里另一个自定义接口包时只--packages-select自己改的包可能会漏掉接口包的重新编译导致新接口字段不起作用。用--packages-up-to会把当前包及其依赖链上的包都构建一遍省心很多colcon build --packages-up-to my_package5.3 几个能显著提高效率的小习惯我自己的.bashrc里放了这样几个 alias用起来非常顺手alias cbscolcon build --symlink-install alias cbcolcon build alias sbsource install/setup.bash alias r2ros2如果开发环境里同时涉及 ROS1 Noetic 和 ROS2 Humble建议单独写两个 alias 来切换环境不要在一个终端里反复混合 source。比如alias ros1_envsource /opt/ros/noetic/setup.bash alias ros2_envsource /opt/ros/humble/setup.bash还有一点是关于RMW_IMPLEMENTATION的。ROS2 底层 DDS 实现可选比如默认的 Fast DDS、Cyclone DDS、RTI Connext 等。如果机器上装了多套 DDS 实现偶发通信不稳定的问题可以考虑切换RMW_IMPLEMENTATION环境变量试试。不过对大多数项目来说默认 Fast DDS 完全够用不用一开始就折腾这个只有遇到通信异常且排查无果时才值得尝试切换。最后分享一个我自己的体会。ROS2 指令看着多但它的设计非常规律核心就是ros2 资源类型 动作。与其死背命令不如把ros2 tab的自动补全用起来按两下 Tab 就能看到所有候选比翻文档快得多。等这些指令用顺手了你会发现 ROS2 的命令行工具比 ROS1 更加统一也更好记。日常开发里真正高频的其实就这么几十条把这几十条练成肌肉记忆剩下的交给自动补全和--help就够了。