命令基于 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 1 | ROS 2 |
|---|---|---|
| 环境 | source /opt/ros/noetic/setup.bash | source /opt/ros/humble/setup.bash |
| 编译 | catkin_make | colcon build |
| 包路径 | rospack find | ros2 pkg prefix |
| 节点 | rosnode list | ros2 node list |
| 话题 | rostopic list | ros2 topic list |
| 话题内容 | rostopic echo | ros2 topic echo |
| 服务 | rosservice call | ros2 service call |
| 参数 | rosparam get/set | ros2 param get/set |
| 运行节点 | rosrun | ros2 run |
| 启动文件 | roslaunch | ros2 launch |
| 录制 | rosbag record | ros2 bag record |
