企业官网建设流程全解析

在ROS里做机器人开发，最绕不开的一个工具就是rviz。我接触不少刚入门的同学，装好ROS、敲完rosrun rviz rviz，看到弹出一个灰色三维场景，第一反应往往是“这东西是不是坏了”。其实rviz大概率没坏，只是你还没告诉它，你想让它在哪个坐标系下、订阅哪些话题、显示什么内容。

这篇就把rviz从安装到熟练使用，拆开揉碎讲一遍。内容涉及环境准备、界面布局、Fixed Frame坐标系、点云和路径的现实案例、还有我这些年踩过的坑和排查思路。适合刚学ROS的大学生、转行做机器人开发的工程师、以及做毕设或比赛项目时被rviz各种奇怪表现折磨过的人。看完你会发现，rviz不是一个“能用就行”的附属工具，而是真正帮你把机器人状态“看透”的核心调试平台。

1. 为什么每个ROS开发者都绕不开rviz

1.1 rviz到底能显示哪些东西

rviz全称是ROS Visualization，翻译成大白话就是“ROS数据可视化工具”。它最核心的能力，是把ROS里以话题（Topic）形式发布的数据，实时画到一个三维场景里。不需要你写任何绘图代码，只要数据发布出来了，rviz就能认。

实际开发中我常用的显示类型有这么几类：

• 传感器数据：激光雷达LaserScan、三维点云PointCloud2、摄像头图像Image、IMU、GNSS定位数据。
• 机器人自身状态：URDF机器人模型、关节状态、传感器安装位置、TF坐标系树。
• 算法输出结果：栅格地图Map、代价地图、全局路径Path、局部轨迹、目标点、粒子滤波的粒子分布、路径规划器生成的候选轨迹。
• 自定义调试信息：Marker和MarkerArray，这个特别灵活，能在三维空间里画箭头、画框、画文字，我经常用它来标定目标点或者可视化算法中间结果。

换句话说，rviz就像机器人的“行车记录仪+仪表盘”。你的激光雷达扫描到什么、底盘当前在哪个位置、规划器打算往哪里走，全部摆在同一个三维画面里。做SLAM时你盯着点云和地图看配准效果；做导航时你盯着路径和代价地图调参数；做机械臂时你盯着模型和规划轨迹走位。可以说没有rviz，调机器人就跟瞎开一辆没有仪表盘的车一样。

1.2 为什么不用自己写可视化程序

有同学会问，我自己用Qt或者Python的matplotlib画图表不行吗？当然可以画，但成本和收益完全不成比例。rviz本身是ROS社区花了大量精力维护的通用可视化平台，它跟ROS的消息机制天然绑定。你只需要在rviz里添加一个显示组件，选择对应的话题，数据就会自动渲染出来。

更要命的是，你的机器人硬件和算法是每天都在变的。今天你发布激光雷达话题，明天你新增了一个点云话题，后天你又把算法改成了导航。如果自己写可视化程序，意味着每换一个数据格式就要改一遍代码，调试周期会变得非常长。而rviz有一套完整的插件机制，社区已经写好了几百种显示插件，从图像到三维模型全覆盖。你要做的只是“选择话题”和“点添加”。

团队协作也是rviz的巨大优势。rviz支持把当前整个显示配置保存为一个.rviz文件，里面记录了所有显示组件的参数、视角、坐标系。调试机器人时，我把调好的.rviz文件放进launch文件里，其他同事一启动就能看到完全一样的视图，不用每个人重新配置一遍。这种“配置即分享”的体验，是自研可视化程序很难复刻的。

2. 环境准备与安装，处理好“rviz打不开”的老大难问题

2.1 安装ROS和rviz的几种方式

要在电脑上使用rviz，前提是先装好ROS。目前主流的组合有两种：Ubuntu 20.04装ROS 1 Noetic，Ubuntu 22.04装ROS 2 Humble。注意ROS 1和ROS 2里的rviz不太一样，ROS 2的命令是rviz2，配置文件格式也不同。用以前的教程时，先看清楚对方用的是哪个版本，否则会卡在命令不存在的坑里。

安装ROS本身不是特别难，但很多人卡在系统源和ROS软件源的配置上。如果你用的是“鱼香ROS一键安装”这类脚本，它会帮你把软件源、ROS源、rosdep等一次性配置好，适合新手快速搭环境。如果你是老手，也完全可以直接按官网步骤安装：先添加ROS软件源，再sudo apt update，最后安装完整桌面版。

以Ubuntu 20.04 + ROS Noetic为例，完整桌面版安装命令是：

sudo apt install ros-noetic-desktop-full

ROS 2 Humble类似：

sudo apt install ros-humble-desktop

这里的desktop版本已经包含了rviz。如果你嫌桌面版太大，只想装rviz，也可以单独装：

sudo apt install ros-noetic-rviz sudo apt install ros-humble-rviz2

无论哪种方式，装完都要记得source一下环境变量：

echo "source /opt/ros/noetic/setup.bash" >> ~/.bashrc source ~/.bashrc

ROS 2则改成：

echo "source /opt/ros/humble/setup.bash" >> ~/.bashrc source ~/.bashrc

2.2 如何验证rviz能否正常启动

装好之后，先不要急着做复杂的事，先确认rviz能正常弹窗。ROS 1里，打开一个终端，启动roscore：

roscore

再开一个终端，运行：

rosrun rviz rviz

ROS 2里不需要roscore，直接运行：

rviz2

这步如果能弹出一个三维界面，恭喜你，环境基本没问题。如果没反应，或者闪退，或者双击图标没任何反馈，那就需要排查了。

我遇到最多的“rviz打不开”场景，是在虚拟机和双显卡电脑上。虚拟机里需要在虚拟机设置里开启3D加速，否则OpenGL渲染会异常。双显卡笔记本经常是NVIDIA独显和Intel核显切换的问题，可以试试用软件渲染方式启动：

LIBGL_ALWAYS_SOFTWARE=1 rosrun rviz rviz

ROS 2就是：

LIBGL_ALWAYS_SOFTWARE=1 rviz2

软件渲染虽然性能差点，但大概率能把界面拉起来，至少能确认rviz本身没坏。

另外一个很容易被忽略的点是：rviz启动时如果带了无效配置，也会表现成闪退。你可以先不带任何参数启动，看能不能出现默认界面。如果手头有别人分享的.rviz文件，可以用-d参数指定配置启动，但前提是那些话题必须存在，否则打开后也是一片空白。

3. 界面布局与核心概念，看懂rviz才谈得上用好

3.1 rviz主界面上有哪些关键功能区

第一次打开rviz，你会看到一个3D视图，里面有一张灰色网格，这就是固定坐标系所在平面的显示。默认视角是俯视带一点倾斜，可以按住鼠标左键旋转视角、滚轮缩放、右键平移，这个交互习惯和三维建模软件基本一致。

界面左侧是Display面板，这是rviz最核心的部分。最上方是Global Options，里面有Fixed Frame、Frame Rate、Background Color等全局参数。往下就是一个个Display，也就是“显示组件”。每添加一个话题数据，就会在这里多一行组件。组件前面的复选框可以控制是否显示，行内的箭头可以展开详细参数，比如点云颜色、尺寸、话题名称等。

顶部工具栏有视角切换、测量工具等。如果装了导航功能包，还会出现“2D Pose Estimate”和“2D Nav Goal”这两个按钮，可以在地图上手动指定机器人初始位置或者发布目标点。这是导航调试中非常高频的操作。

底部状态栏会显示当前实时帧率FPS、场景树状态、全局帧的时间戳信息。如果你发现画面卡得厉害，先看这里显示的帧率，再决定要不要降低Global Options里的Frame Rate。

3.2 Fixed Frame坐标系，为什么选错就什么都乱

rviz里最重要、也最容易犯错的概念，就是Fixed Frame。很多刚接触的人不理解：为什么我明明发布了点云，rviz里却什么都没有？为什么机器人模型跑到了几百米外？为什么地图和激光雷达数据不重合？这些问题八成是Fixed Frame没选对。

先打个比方。Fixed Frame的意思是“整个世界固定在哪一个参考系上”。这就像你在墙上钉了一张地图，地图就是唯一固定的东西，你所有的标注都要以这张地图为准。如果你站在地图的某个街道上，但你手里的定位信号用的是另一个城市的地图坐标，那你的位置就画不到当前这张地图上。

在rviz里，每一个显示项的数据都会先转换到Fixed Frame，再绘制出来。如果某个数据所在坐标系的TF没有转换到Fixed Frame的路径，rviz就不知道该把它放在哪里，于是就不显示，或者显示在半空中、原点处。

常见的选择规则是这样的：

• 做导航和SLAM建图时，通常选map或odom作为Fixed Frame，这样才能把地图、机器人、激光雷达统一到世界坐标系下。
• 单纯调试传感器数据时，可以选机器人的base坐标系，比如base_link或base_footprint，这样点云就跟着机器人走，适合看传感器是否正常。
• 调试机械臂时，选机械臂的base坐标系，比如base或base_link，这样模型不会乱飞。

查看TF树是排查坐标系问题的第一步。你可以用命令：

rosrun rqt_tf_tree rqt_tf_tree

ROS 2用：

ros2 run rqt_tf_tree rqt_tf_tree

这个工具会把所有坐标系之间的父子关系画出来。如果机器人模型没有显示，先打开TF树看看，地图、机器人、传感器这几个关键frame之间是不是连成了一条线。如果链路断了，rviz就无法完成坐标变换，显示自然就是空的。

3.3 Add面板：按话题添加显示组件

知道了Fixed Frame是什么，接下来就是往场景里加内容。点击左上角“Add”按钮，会弹出两个页面：一个是“By display type”，按显示组件类型找；一个是“By topic”，直接按系统当前已有的话题找。

我平时的习惯是先跑rostopic list看一眼当前有哪些话题，然后在“By topic”页签里直接找到对应话题双击添加。这种方法不会认错类型，而且添加的时候rviz会自动选择合适的显示组件。

比如系统里正在发布/scan（激光雷达），你双击之后，rviz会自动添加一个LaserScan显示组件并绑定到/scan话题。如果系统里正在发布/points（点云），双击后会自动添加PointCloud2组件。

显示组件添加完之后，你还需要检查它的细节参数。以PointCloud2为例，如果点云没有颜色，检查Color Transformer是否设置为Intensity；如果点云大小不合适，调整Size参数；如果点云一闪一闪，把Decay Time调大一点，让上一帧数据保留更长时间。

4. 从零到可复现：三个典型的rviz可视化实操案例

4.1 TurtleBot3仿真环境里看地图和导航路径

很多人学ROS第一个实战就是仿真机器人导航，这套流程特别能体现rviz的价值。以TurtleBot3为例，安装好相关功能包后，先启动Gazebo仿真环境：

export TURTLEBOT3_MODEL=burger roslaunch turtlebot3_gazebo turtlebot3_world.launch

再开一个终端，启动导航功能：

roslaunch turtlebot3_navigation turtlebot3_navigation.launch

这个launch文件会连同rviz一起启动，而且加载了写好的.rviz配置。你会在rviz里看到栅格地图、激光雷达扫描线、机器人的代价地图、以及TF模型。

点击顶部的“2D Nav Goal”按钮，然后在地图上拖拽一个箭头，指定机器人的目标位置和朝向。松手之后，你会看到代价地图上出现一条全局路径，同时局部路径规划器也会实时更新。这时候rviz就成了观察导航算法行为的“放大镜”：如果路径穿过了障碍物，说明代价地图膨胀半径或者规划器参数有问题；如果路径抖动得厉害，说明定位或局部规划器参数需要调整。

第一次做这个案例时，很多人会遇到“有导航rviz但没有地图”的情况。先检查左侧Display列表里Map组件的话题是不是/map，Fixed Frame是不是map。如果地图话题没选对，画面里自然什么都没有。

4.2 用ROS bag回放点云，在rviz里看传感器数据

真实项目里，做传感器数据处理时，通常不是直接把车开起来边跑边调，而是先录一段rosbag，再回放调试。这个流程结合rviz非常顺手，我用海康威视相机、深度相机做过很多次。

假设你有一个录制好的包文件sensor.bag，里面包含点云话题。先看包里有什么：

rosbag info sensor.bag

然后回放数据：

rosbag play sensor.bag

再开一个终端，启动rviz。在Add面板里，通过“By topic”找到点云话题，双击添加。关键一步是把Fixed Frame设置成传感器所在的坐标系，比如camera_link或者其他对应的frame，否则点云会跑到地图原点或者完全不显示。

点云显示还有一些调节技巧。比如把PointCloud2显示组件的Decay Time从0改成0.5，就能让点云帧之间有一定保留，观察起来更像连续画面。如果点云是单色的，把Color Transformer改成Intensity，就能根据反射强度着色，sensor细节会清楚很多。Size参数控制点的大小，点太稀疏就调大，点太大糊成一片就调小。

用rosbag回放调试的好处是数据完全可复现，不会因为现场机器人的状态变化导致问题时好时坏。我调传感器驱动时，习惯先录几分钟数据，然后在办公室里一遍一遍回放，直到rviz里看到的点云效果稳定了，再拿真机去验证。

4.3 显示UR10机械臂模型和运动轨迹

做机械臂开发时，rviz同样是好帮手。以UR10为例，如果你有ur_description功能包，可以先把机器人的URDF模型加载到rviz里：

roslaunch ur_description ur10_upload.launch

然后在rviz里添加RobotModel组件，把Topic设置成/robot_description，Fixed Frame设置成base或base_link。这时候你就应该能看到一个完整的UR10三维模型。转动机械臂关节，模型会跟着变化，看起来就像真机一样。

如果模型显示不出来，或者各部分错位，我一般从两个方向排查：一是/robot_description话题是否有数据，二是TF树是否完整。机械臂的模型描述话题如果为空，rviz就不知道要画什么；TF树如果缺少关节之间的变换，模型就会变成错位的碎片。

配合MoveIt做运动规划时，rviz还能显示规划出的轨迹。启动MoveIt的demo launch后，你会在rviz里看到MotionPlanning面板。在这里可以拖动机械臂末端执行器的目标位置，点击Plan，规划出的轨迹会以虚拟机械臂的形式展示出来。这个功能在验证算法和做仿真时至关重要，不用碰真机就能看规划结果靠不靠谱。

4.4 更多拓展：图像、Marker和Octomap可视化

除了上面讲的点云、模型、路径，rviz也能显示摄像头图像话题。添加一个Image显示组件，选择图像话题，就能实时看到画面。这在调试视觉SLAM、目标检测时很有用。

Marker是另一个灵活性极高的显示方式。你可以用MarkerArray往rviz里发一些自定义几何体，比如箭头、圆柱、文字方块。我经常用Marker来显示算法里的目标点、障碍物框、机器人预瞄轨迹等。只要节点发布visualization_msgs/MarkerArray话题，rviz就自动渲染，不需要改任何配置。

如果你做三维建图，rviz还能通过Octomap插件显示八叉树地图。跟二维栅格地图相比，三维地图视野更直观，在无人机、机械臂避障场景里几乎是必备。配合Gazebo仿真，你可以很直观地看到传感器扫描出来的三维空间结构。

5. 常见问题排查实录，遇到问题先按照这个顺序检查

5.1 rviz打不开、闪退、黑屏怎么办

老规矩，先看启动方式：命令行启动，不要双击图标。命令行里会打印错误日志，问题定位快很多。如果你在终端输入rosrun rviz rviz之后回车，等了半天没反应，先确认roscore有没有在跑。ROS 1里，roscore没启动的话，rviz会卡在连接阶段，看起来就像卡死。

如果启动后闪退，优先怀疑显卡和OpenGL问题。虚拟机用户检查3D加速是否开启；双显卡用户试一下软件渲染启动：

LIBGL_ALWAYS_SOFTWARE=1 rosrun rviz rviz

这条命令能让rviz用CPU软渲染，虽然性能一般，但能用来确认是不是显卡渲染导致的崩溃。

黑屏但窗口在，可能是背景色太深或视角歪了。试着把Global Options里的Background Color改成浅色调，或者双击视图然后按快捷键重置视角。还有一个小坑是Remote Desktop远程连接时OpenGL支持不佳，会出现白屏或内容不刷新，这时候只能尽量在真机本地跑，或者改用软件渲染。

5.2 点云、地图、模型都显示不出来

这类问题非常常见，而且原因高度集中，我整理了一个速查表：

排查顺序一般从“话题有没有数据”开始，然后看“Fixed Frame对不对”，最后看“TF树连不连得上”。这四件套基本能解决九成以上的显示问题。

在ROS 2里，由于DDS通信中间件引入了QoS策略，还可能出现一种ROS 1时代少见的状况：传感器节点发布的是SensorData QoS，rviz订阅的是Default QoS，两者策略不匹配，导致数据死活不出来。如果你确认话题有数据、Fixed Frame正确、TF没问题，但仍然看不到点云，可以把Display里对应组件的Reliability Policy改成Best Effort试试。

5.3 rviz极度卡顿、帧率很低怎么办

卡顿问题在点云和地图同时显示时特别明显。Rviz渲染点云是按点来算的，点一多GPU负载就上去了。解决思路有几个方向：

• 降低Global Options里的Frame Rate，从默认的30降到15或10，画面丝滑感弱一点但操作不卡。
• 点云显示组件里，把Decay Time调小，减少同时驻留的点云数量。
• 不要同时显示所有Display。调试哪个就开哪个，其他组件取消勾选，能显著降低渲染负担。
• 如果机器性能实在拉胯，可以考虑用机器人端的传感器降采样，比如在点云发布节点里做VoxelGrid滤波，降低点的密度，同样的数据量更小。

另外，rviz里显示机器人模型时，如果模型带太多高精度mesh文件，也会吃帧率。URDF里尽量使用简化mesh，或者把RobotModel显示组件的Alpha设成0.5，减少透明物体填充运算，效果会好很多。

5.4 排查问题的三条实用命令

排查rviz问题不能光靠眼睛看，要会用命令行工具交叉验证。这里分享三个我常用的命令：

一是rqt_graph，它能画出当前ROS节点之间的话题连接关系。如果rviz里没数据，先用它看看发布节点和rviz之间是不是真的连上了。ROS 2用ros2 run rqt_graph rqt_graph。

二是rostopic hz，检查话题发布频率。比如点云话题只有0.1Hz，那你在rviz里看到画面“卡顿”其实是数据本身太稀疏，并不是rviz的问题。ROS 2用ros2 topic hz。

三是rostopic echo，直接看消息内容。比如地图话题能打印出分辨率、宽度、高度，但打印不出有效数据，说明map_server生成的地图本身就是空的。ROS 2用ros2 topic echo。

这套组合拳打下来，问题基本能精确定位到位。我见过不少人盯着rviz白屏看了半天，其实用rostopic hz一看，话题压根没数据，还没到渲染那一步就已经断了。

写在最后，一点个人经验

我自己从ROS 1一路用到ROS 2，rviz几乎是每天都要开着的工具。刚开始我也被那个三维灰色界面折磨过，点云怎么都不显示，后来才知道是Fixed Frame选错了。用过这么多年，最大的体会是：rviz出的问题，绝大多数不是软件bug，而是数据流和坐标系没理顺。遇到问题别急着怀疑工具，先按“数据话题、Fixed Frame、TF树、时间戳”这套顺序去排查，方向对了，问题就走了一半。

再分享一个小技巧：每次调好布局后，记得把配置保存下来。在rviz左侧Display面板上面，点击文件菜单里的Save Config As，存成一个.rviz文件。之后启动时直接用-d参数加载配置，或者放进launch文件里，就不用每次打开后重新Add一堆组件了。团队协作时，这个文件更是宝贝，统一视图、统一参数，效率能高出一大截。

后面如果你接了真实的传感器、自己的底盘、机械臂，rviz这套逻辑是通用的。先把Fixed Frame和TF理顺，剩下的显示问题都是水到渠成的事。