ROS 可视化与调试工具：rviz / rqt 与命令行四件套（十一）
通用基础优先 · 第十一篇｜ROS 通识系列｜Docker 实战
一图读懂本文：rviz 仪表盘 → 命令行四件套 → rqt 面板 → headless 排查 → 采前/采后自检清单。
写节点只是第一步，"看得见、查得清"才能保证数采质量。这一篇盘点 ROS 的两大 GUI 工具和一组命令行探针——采前自检、采后回放排查都离不开它们。
一、rviz：机器人的"仪表盘"
rviz（ROS 2 是rviz2）是 3D 可视化工具：把点云、图像、坐标系树、机器人模型（URDF）叠在一起看。数采前用它确认"相机真的看到了料框、TF 树没断"。
# 需要图形界面：用 desktop 镜像 + 把本机显示挂进容器 docker run -it --rm -e DISPLAY=$DISPLAY -v /tmp/.X11-unix:/tmp/.X11-unix \ ros:jazzy-desktop rviz2无显示器环境：服务器端没 GUI 时，rviz 跑不起来。这时改用命令行探针（下面第二节）和 rqt 的无窗口插件（如 rqt_graph）更现实。
新手视角 · rviz 像"上帝视角"，rqt 像"仪表盘"：rviz 是从外部俯瞰机器人——相机看到什么、每个坐标系在哪、夹爪要往哪走，一目了然；rqt 则是坐在驾驶舱里看仪表——转速表（rqt_plot 曲线）、故障灯（rqt_console 日志）。新手最容易忽略的是：很多"数据是坏的"问题，在 rviz 里一眼就能看出来（TF 树断了、点云漂了）。
二、命令行四件套（headless 也能用，最常用）
| 命令 | 用途 | 数采场景 |
|---|---|---|
ros2 topic echo | 实时打印话题内容 | 确认关节角/图像在发 |
ros2 topic hz | 看发布频率 | 确认"采够快了没" |
ros2 node info | 看节点订阅/发布/服务 | 排查"为什么没收到" |
ros2 run rqt_graph rqt_graph | 画出节点连接图 | 一眼看全链路是否连通 |
三、rqt：模块化调试面板
rqt 是一组可插拔小工具：
- rqt_plot：把数值话题（如关节角）实时画成曲线——看采集是否平稳；
- rqt_console：集中看所有节点的日志（按级别过滤）；
- rqt_image_view：单帧看相机图像（无需 3D 窗口）。
ros2 run rqt_plot rqt_plot /joint_states/position ros2 run rqt_console rqt_console四、Docker 实战：headless 排查一条链路
# 起 talker 后，不开 GUI 也能把链路查个底朝天 ros2 node list ros2 topic hz /chatter ros2 topic echo /chatter | head ros2 run rqt_graph rqt_graph # 若容器有 X 转发则出图五、接回数采平台
- 采前用 rviz + rqt_plot 自检：相机、关节角、TF 都在且频率达标；
- 采后用 ros2 bag play + topic echo/hz 回放复核，确认数据没丢帧、没错位；
- 把这些检查固化进 launch 前的"采前自检清单"，是保证数据集质量的第一道防线。
老手温故 · 自检看"抖动"，不只看均值：验收采集链路，
ros2 topic hz的均值要看，min/max 抖动更要看——均值 30Hz 但 min 掉到 3Hz，说明驱动被 CPU 争抢，采出来就是丢帧数据，这种 bag 应在质检环节判废。现场系统级排查先跑ros2 doctor --report（网络、环境变量、版本一致性一次输出）；录制端如果是独立进程，注意它的 I/O 抢占——录制卡顿不会报错，只会静默丢消息，这是最阴险的采数事故。六、小结与下篇
- rviz/rviz2 是 3D 仪表盘，需 GUI（desktop 镜像 + X 转发）；
- 命令行四件套（echo/hz/node info/rqt_graph）headless 可用，最常用；
- rqt_plot / rqt_console / rqt_image_view 覆盖曲线、日志、图像；
- 采前自检 + 采后回放复核 = 数据集质量防线；
- 下一篇：时间与时序——为什么 bag 回放要和原始采集"时间对齐"，亚毫秒同步意味着什么。
参考资料：ROS 2 官方 Tutorials（rviz / rqt 用户指南）；rqt 插件文档 docs.ros.org/en/jazzy/How-To-Guides/Guides/RQt。示例基于 ros:jazzy-desktop。
