每日壁纸

ROS 常用命令速查

Published on
Published on
/7 mins read/---

命令基于 ROS 1(Noetic / Melodic),在 bash 下使用。ROS 2 的对应关系放在最后一节。

一、环境与工作空间

# 加载当前 ROS 发行版环境(装好后一般已写进 ~/.bashrc)
source /opt/ros/noetic/setup.bash
 
# 确认当前发行版
echo $ROS_DISTRO
rosversion -d
 
# 每次编译后刷新工作空间环境
cd ~/catkin_ws
source devel/setup.bash
 
# 编译整个工作空间
catkin_make
 
# 只编译指定包,并输出详细日志
catkin_make --only-pkg-with-deps <包名>
catkin_make -DCMAKE_BUILD_TYPE=Release
 
# 清理后重新编译
catkin_make clean && catkin_make

如果装了 catkin_tools,用 catkin build 与 catkin clean 替代 catkin_make。

二、包与路径查找

# 进入某个包的目录(相当于 cd $(rospack find <包名>))
roscd <包名>
 
# 查找包路径
rospack find <包名>
 
# 列出所有包 / 查找包含某关键字的包
rospack list
rospack list | grep <关键字>
 
# 查看包的依赖
rospack depends <包名>          # 递归依赖
rospack depends1 <包名>         # 直接依赖
 
# 安装包的系统依赖(读取 package.xml)
rosdep install --from-paths src --ignore-src -r -y
 
# 查看包信息
rosmsg show <消息类型>
rossrv show <服务类型>

三、节点

# 列出正在运行的节点
rosnode list
 
# 查看节点详情:订阅/发布的话题、服务、PID
rosnode info /<节点名>
 
# 结束某个节点(慎用,优先用 Ctrl+C)
rosnode kill /<节点名>
 
# 清理已退出的僵尸节点
rosnode cleanup

四、话题(Topic)

# 列出所有话题
rostopic list
 
# 实时打印话题内容
rostopic echo /<话题名>
 
# 只打印某个字段
rostopic echo /<话题名>/<字段>
 
# 查看话题类型、发布者、订阅者
rostopic info /<话题名>
 
# 查看话题类型
rostopic type /<话题名>
 
# 查看发布频率
rostopic hz /<话题名>
 
# 查看带宽占用
rostopic bw /<话题名>
 
# 手动往话题发一条消息
rostopic pub -1 /<话题名> <消息类型> "<字段>: <值>"
 
# 以 10Hz 持续发布
rostopic pub -r 10 /<话题名> <消息类型> "{data: 1}"

-1 表示只发一次;消息字段可以用 Tab 补全模板。

五、服务(Service)

# 列出所有服务
rosservice list
 
# 查看服务类型与提供者
rosservice info /<服务名>
 
# 查看服务类型定义
rosservice type /<服务名>
 
# 调用服务
rosservice call /<服务名> "<参数>"
 
# 查看服务参数模板
rosservice args /<服务名>

六、参数服务器

# 列出所有参数
rosparam list
 
# 读取参数
rosparam get /<参数名>
 
# 写入参数
rosparam set /<参数名> <值>
 
# 把参数保存成 YAML / 从 YAML 加载
rosparam dump params.yaml
rosparam load params.yaml
 
# 删除参数
rosparam delete /<参数名>

七、运行与可视化

# 运行单个节点
rosrun <包名> <可执行文件名>
 
# 运行 launch 文件
roslaunch <包名> <文件名>.launch
 
# 先检查 launch 会启动哪些节点,不真正运行
roslaunch --nodes <包名> <文件名>.launch
 
# 覆盖 launch 里的参数
roslaunch <包名> <文件名>.launch <参数名>:=<值>
 
# 查看节点与话题的连接图
rqt_graph
 
# 打开可视化工具
rviz            # 三维可视化
rqt             # 插件式调试面板
rqt_plot        # 曲线绘制

八、录制与回放(rosbag)

# 录制全部话题
rosbag record -a
 
# 只录制指定话题
rosbag record /scan /tf /odom -o my_bag
 
# 分片保存,单文件不超过 500MB
rosbag record -a -o split_bag --split --size=500
 
# 查看 bag 信息:话题、时长、消息数
rosbag info <文件>.bag
 
# 回放,可调速、可指定话题
rosbag play <文件>.bag
rosbag play -r 0.5 <文件>.bag
rosbag play <文件>.bag --topics /scan
 
# 修复录制中断的 bag
rosbag reindex <文件>.bag

九、TF 与系统自检

# 查看两个坐标系之间的变换
rosrun tf tf_echo <源坐标系> <目标坐标系>
 
# 生成 TF 树图(PDF)
rosrun tf view_frames
 
# 检查配置与包依赖问题
roswtf
 
# 查看 ROS 主节点状态
rosnode list
rostopic list -v

十、常见排查顺序

组合使用,通常能从「没反应」定位到具体环节:

# 1. 主节点有没有起来
rosnode list
 
# 2. 话题是否已发布、类型是否对得上
rostopic list
rostopic info /<话题名>
 
# 3. 数据是否真的在流动
rostopic hz /<话题名>
rostopic echo /<话题名> | head -20
 
# 4. 参数是否加载正确
rosparam list | grep <关键字>
 
# 5. 整体连接关系是否符合预期
rqt_graph

附:ROS 2 对照

用途ROS 1ROS 2
环境source /opt/ros/noetic/setup.bashsource /opt/ros/humble/setup.bash
编译catkin_makecolcon build
包路径rospack findros2 pkg prefix
节点rosnode listros2 node list
话题rostopic listros2 topic list
话题内容rostopic echoros2 topic echo
服务rosservice callros2 service call
参数rosparam get/setros2 param get/set
运行节点rosrunros2 run
启动文件roslaunchros2 launch
录制rosbag recordros2 bag record