第一次做机器人项目,卡住的往往不是算法,而是模型站不起来、机器人穿过地板、RViz 里只有一堆白色线框。URDF 决定机器人长什么样、关节怎么连;Gazebo 决定物理世界如何回应它。两者都不是"写一次就对"的东西,需要对着 TF、惯量和碰撞体反复调。本文用 Ubuntu 24.04 + ROS 2 Jazzy + Gazebo Harmonic 走一遍:手写 URDF、在 RViz 里检查,再放进仿真世界开动。

一、URDF 是一棵坐标树,不是模型文件

URDF 用 link(刚体)和 joint(关节)描述机器人,整体是一棵只有一个根节点的树。每个 link 可以有三部分内容:visual(长什么样)、collision(碰撞检测用什么形状)、inertial(质量与转动惯量)。只写 visual,RViz 好看但仿真里没有碰撞;只写 collision 不写 inertial,物理引擎只能猜质量。

元素作用常见错误
link一个刚体,含 visual / collision / inertial漏掉 collision 或 inertial
joint连接父子 link,定义自由度与限位parent / child 写反、限位单位写错
originxyz 平移 + rpy 旋转误以为是世界坐标,其实是父坐标系
mesh外观网格文件(STL / DAE)路径写死、单位不是米
gazebo 扩展插件、传感器、材质等仿真专有属性标签层级放错,Gazebo 直接忽略

另一个必须分清的概念:URDF 是 ROS 生态的描述格式,SDF 是 Gazebo 的仿真格式。Gazebo 加载 URDF 时会先转成 SDF,因此 URDF 里表达不了的东西(闭链、软体、部分传感器参数)要靠 <gazebo> 标签扩展,或者干脆用 SDF。别指望一份 URDF 打通所有仿真器,这是常态而不是失败。URDF 本身没有单位声明,所有数值默认按米、千克、秒、弧度理解——这是规范,不是可选约定。

URDF 本身不发布任何坐标变换。真正把模型接到 TF 树上的是 robot_state_publisher:它读 robot_description,订阅 /joint_states,计算每个 link 相对父 link 的变换并广播。固定关节的变换会发到 /tf_static,可动关节跟随关节角实时变化。所以"RViz 里模型不显示"通常不是模型文件坏了,而是 TF 或 joint_states 断了。

二、手写一个两轮差速底盘

用 xacro 参数化轮径、轮距,后面改尺寸只动属性。核心结构是:底盘 box、左右两个 continuous 关节的轮子、前后各一个 caster 万向轮(用球体加 fixed 关节近似)。下面是精简版:

<?xml version="1.0"?>
<robot xmlns:xacro="http://www.ros.org/wiki/xacro" name="diffbot">
  <xacro:property name="wheel_radius" value="0.06"/>
  <xacro:property name="wheel_width" value="0.03"/>
  <xacro:property name="wheel_sep" value="0.32"/>
  <xacro:property name="base_mass" value="2.0"/>

  <link name="base_link">
    <visual>
      <geometry><box size="0.28 0.24 0.10"/></geometry>
      <material name="grey"><color rgba="0.6 0.6 0.6 1"/></material>
    </visual>
    <collision><geometry><box size="0.28 0.24 0.10"/></geometry></collision>
    <inertial>
      <mass value="${base_mass}"/>
      <inertia ixx="0.005" ixy="0" ixz="0" iyy="0.006" iyz="0" izz="0.008"/>
    </inertial>
  </link>

  <xacro:macro name="wheel" params="side reflect">
    <link name="${side}_wheel_link">
      <visual>
        <origin rpy="1.5708 0 0"/>
        <geometry><cylinder radius="${wheel_radius}" length="${wheel_width}"/></geometry>
      </visual>
      <collision>
        <origin rpy="1.5708 0 0"/>
        <geometry><cylinder radius="${wheel_radius}" length="${wheel_width}"/></geometry>
      </collision>
      <inertial>
        <mass value="0.2"/>
        <inertia ixx="0.0002" ixy="0" ixz="0" iyy="0.0002" iyz="0" izz="0.0004"/>
      </inertial>
    </link>
    <joint name="${side}_wheel_joint" type="continuous">
      <parent link="base_link"/>
      <child link="${side}_wheel_link"/>
      <origin xyz="0 ${reflect * wheel_sep / 2} -0.03"/>
      <axis xyz="0 1 0"/>
    </joint>
  </xacro:macro>
  <xacro:wheel side="left" reflect="1"/>
  <xacro:wheel side="right" reflect="-1"/>
</robot>

关节类型也要选对:轮子用 continuous(无限旋转),机械臂关节用 revolute 并写清 limit,直线滑台用 prismatic,结构件用 fixed。差速底盘属于典型的非完整约束系统,URDF 只描述几何与关节,不约束"不能横移",那要靠控制器保证。

惯量别随手填。圆柱绕自身轴是 Izz = 0.5 * m * r²,绕径向是 Ixx = Iyy = m * (3r² + h²) / 12;长方体三个轴分别是 m * (a² + b²) / 12 的轮换。数值量级错了,仿真里机器人会抖、会穿模、会自己飞走,而代码层面完全看不出问题。

检查与预览的四条命令:

sudo apt install ros-jazzy-urdf-tutorial ros-jazzy-xacro ros-jazzy-joint-state-publisher-gui -y
xacro diffbot.urdf.xacro > diffbot.urdf
check_urdf diffbot.urdf
ros2 launch urdf_tutorial display.launch.py model:=$PWD/diffbot.urdf

check_urdf 会打印关节树,父子关系错一眼就能看出来。预览 launch 会启动 robot_state_publisher、joint_state_publisher_gui 和 RViz;拖动滑块,continuous 关节的轮子应该跟着转。如果 RViz 里模型是白色的、飘在原点,通常是 TF 没发出来或 fixed frame 选错。

三、放进 Gazebo:spawn、插件与桥接

Jazzy 对应的现代 Gazebo 是 Harmonic(Gazebo Classic 11 已于 2025 年 1 月 29 日停止支持,搜到 gazebo 命令的旧教程请直接跳过)。现代 Gazebo 把渲染、物理、传感器拆成可插拔的系统插件,世界文件用 SDF 描述,人形、轮式、机械臂都放在同一套体系里。安装与启动:

sudo apt install gz-harmonic ros-jazzy-ros-gz -y
ros2 launch ros_gz_sim gz_sim.launch.py gz_args:="-r empty.sdf"

接着先启动你自己的 description launch(里面有 robot_state_publisher 发布 robot_description),再把模型生成到世界里:

source /opt/ros/jazzy/setup.bash
ros2 run ros_gz_sim create -name diffbot -topic /robot_description -z 0.05

让轮子真正转起来,需要在 URDF 里挂差速驱动插件。<gazebo> 标签放在 <robot> 下、与 link 平级:

<gazebo>
  <plugin filename="gz-sim-diff-drive-system" name="gz::sim::systems::DiffDrive">
    <left_joint>left_wheel_joint</left_joint>
    <right_joint>right_wheel_joint</right_joint>
    <wheel_separation>0.32</wheel_separation>
    <wheel_radius>0.06</wheel_radius>
    <topic>cmd_vel</topic>
    <odom_topic>odom</odom_topic>
    <frame_id>odom</frame_id>
    <child_frame_id>base_link</child_frame_id>
    <publish_odom>true</publish_odom>
    <publish_odom_tf>true</publish_odom_tf>
    <publish_wheel_tf>true</publish_wheel_tf>
  </plugin>
</gazebo>

传感器也挂在 link 上。下面是激光雷达的写法(gpu_lidar 需要渲染引擎支持,无显卡的机器可能起不来;模型或 world 里还需要加载 gz-sim-sensors-system 插件,否则传感器不会发布数据):

<gazebo reference="lidar_link">
  <sensor name="lidar" type="gpu_lidar">
    <always_on>true</always_on>
    <update_rate>10</update_rate>
    <topic>scan</topic>
    <gz_frame_id>lidar_link</gz_frame_id>
    <lidar>
      <scan><horizontal><samples>360</samples><min_angle>-3.14</min_angle><max_angle>3.14</max_angle></horizontal></scan>
      <range><min>0.12</min><max>10.0</max></range>
    </lidar>
  </sensor>
</gazebo>

Gazebo 的话题在它是自己的一套传输层,需要 ros_gz_bridge 翻译成 ROS 2 话题。方括号表示方向:[ 是 Gazebo→ROS,] 是 ROS→Gazebo,省略则双向:

ros2 run ros_gz_bridge parameter_bridge \
  /clock@rosgraph_msgs/msg/Clock[gz.msgs.Clock \
  /cmd_vel@geometry_msgs/msg/Twist]gz.msgs.Twist \
  /odom@nav_msgs/msg/Odometry[gz.msgs.Odometry \
  /scan@sensor_msgs/msg/LaserScan[gz.msgs.LaserScan

方向写反不会报错,只会静默无数据。实际项目里更推荐把桥接写进 launch 的 ros_gz_bridge 节点或 YAML 配置,而不是每次手敲一长串。还要注意桥接只翻译消息,不搬运 TF 树:插件里的 publish_odom_tf 负责发 odom → base_link,机器人各 link 之间的 TF 仍由 robot_state_publisher 发布,两边不能重复发布同一个变换。

四、联调:确认时钟、TF 和控制链路

sudo apt install ros-jazzy-teleop-twist-keyboard -y
ros2 run teleop_twist_keyboard teleop_twist_keyboard
ros2 topic echo /odom
ros2 topic hz /scan
ros2 topic echo /clock --once
ros2 run tf2_tools view_frames
rviz2

检查顺序建议固定下来:先看 /clock 有没有数据,再看 /odom、/scan 频率,然后 view_frames 生成的 PDF 里确认 odom → base_link → lidar_link 连成一条链,最后才在 RViz 里加 RobotModel、LaserScan、TF 三个显示项,fixed frame 选 odom。所有节点都应带 use_sim_time:=true,否则时间戳对不上,TF 会一边查一边报 extrapolation 错误。

键盘遥控节点默认发布 /cmd_vel,如果你的插件里把话题改成了别的名字,用重映射对齐:--ros-args -r cmd_vel:=/cmd_vel。RViz 里能看到激光点打在地面上吗?如果激光整体倾斜或高度不对,先查 lidar_link 的 joint origin,而不是怀疑雷达参数。

必须强调:仿真里的里程计来自插件对轮速的积分,几乎没有打滑、噪声和延迟;真机上轮子会打滑、地面会不平、电机响应有滞后。仿真能验证的是"链路通不通、坐标对不对",不能验证真机的定位精度。

如果 TF 树里出现同名节点被两个发布者争抢,或者某条链时断时续,先检查是不是启动了两次 robot_state_publisher,或者插件与它都在发 odom → base_link。TF 冲突的典型现象是模型闪烁、导航目标随机失败,而日志里往往只有一行不起眼的警告。

五、常见坑

  1. 惯量缺失或量级错:模型抖、弹飞、穿地,先检查惯性张量。
  2. 碰撞体太复杂:直接拿高精度 mesh 做 collision,物理引擎会不稳定,改用 box / cylinder 近似。
  3. 生成高度:从 z=0 生成会与地面穿插,抬高几厘米再落下。
  4. mesh 路径:用 package://包名/...,别写绝对路径;单位不是米时在 mesh 里缩放。
  5. 插件名与版本不匹配:ignition 时代的插件名和 gz 时代不同,装错发行版会出现"插件加载失败"。
  6. 闭链机构:URDF 是树,四连杆、并联平台要么近似,要么改用 SDF。
  7. 传感器 frame:忘了 gz_frame_id,点云和图像会挂在错误坐标系下。
  8. 误用旧教程:Gazebo Classic 已停止支持,命令从 gazebo 变成 gz sim。

调仿真模型时,先把物理调对,再调算法。一个惯量写错、碰撞体穿模的模型,会让 SLAM 和导航的调试结果完全不可信,你却很难定位到根因。

六、项目清单

任务验收标准
用 xacro 参数化底盘尺寸并生成 URDFcheck_urdf 通过,改轮距后模型自动变
在 RViz 中检查模型与 TF轮子随关节状态转动,TF 树无断链
在 Gazebo 中生成并遥控键盘能开动,/odom 与 /scan 有数据
录一段 bag 并回放回放时 RViz 里能重现同一段运动
写一份 README记录 ROS 2、Gazebo、ros_gz 版本与启动命令

做到这里,你已经有了一台"能被软件控制"的虚拟机器人。下一步才是给它装眼睛(标定传感器)、装脑子(SLAM 与导航),或者装手(机械臂与 MoveIt 2)。别跳过模型这一步,后面所有模块都建立在它上面。版本记录也要精确到发行版与包版本:Gazebo 的插件名和 launch 参数在不同版本之间改过不止一次,别人复现失败,十有八九是版本对不上。

如果要在作品集或论文里引用仿真结果,把模型文件、世界文件和版本号一起归档。仿真结果的可信度,取决于别人能不能复现你那个"虚拟世界"。

参考与延伸阅读

外链内容由对应网站负责,访问以实际可用性为准。