第1章 · URDF基础认知

各位工程师朋友，欢迎来到这门实战课。今天咱们先聊聊URDF——这个在机器人开发里几乎天天打交道的文件格式。你可能会觉得“不就是个描述机器人的XML嘛”，但说实话，我见过太多因为URDF写得不规范，导致仿真里机器人乱飘、关节反向、碰撞检测失效的案例。所以第一章，咱们把地基打牢。

1.1 什么是URDF？

URDF全称是Unified Robot Description Format，统一机器人描述格式。说白了，就是用一种标准化的XML语言，把你的机器人长什么样、有哪些关节、每个连杆的尺寸重量、甚至视觉颜色都告诉ROS和仿真器。

我个人习惯把URDF看作机器人的“身份证+体检报告”。身份证记录你长啥样（几何、颜色），体检报告记录你多重、重心在哪、转动惯量多少。没有这张身份证，ROS根本不知道你的机器人是什么东西。

1.2 URDF在机器人开发中的角色

URDF不是只用来“看看”的。它在整个机器人开发生命周期里，至少扮演三个关键角色：

• 可视化与调试：在Rviz里显示机器人模型，检查关节运动、坐标轴对不对。我记得第一次搭四轮小车，左轮怎么都转反，最后发现是URDF里joint的axis写反了——这种坑你迟早会遇到。
• 物理仿真输入：Gazebo等仿真器直接读取URDF里的碰撞几何、惯性参数，来计算接触力、摩擦力。如果你偷懒不写<inertial>，仿真器会默认给一个单位质量，结果机器人轻得像纸片，一碰就飞。
• 导航与规划基础：move_base、导航栈需要知道机器人的 footprint（轮廓），这些信息也来自URDF。我曾经在项目中因为footprint设得比实际大了一圈，导致机器人死活过不去一个门——嗯，后来查了三天才发现是URDF里碰撞盒尺寸写错了。

1.3 URDF文件结构概览

URDF文件本质上是一个XML树。根标签是<robot>，里面包含两种核心元素：link（连杆）和joint（关节）。

咱们直接看一个最简示例，一个两轮差速底盘的核心骨架：

<robot name="my_robot">
  <link name="base_link">
    <visual>
      <geometry>
        <box size="0.4 0.3 0.1"/>
      </geometry>
      <material name="blue">
        <color rgba="0 0.5 1 1"/>
      </material>
    </visual>
    <collision>
      <geometry>
        <box size="0.4 0.3 0.1"/>
      </geometry>
    </collision>
    <inertial>
      <mass value="2.0"/>
      <inertia ixx="0.01" ixy="0" ixz="0"
               iyy="0.01" iyz="0"
               izz="0.02"/>
    </inertial>
  </link>

  <joint name="left_wheel_joint" type="continuous">
    <parent link="base_link"/>
    <child link="left_wheel"/>
    <origin xyz="-0.15 0.2 0" rpy="0 0 0"/>
    <axis xyz="0 1 0"/>
  </joint>
</robot>

你看，结构非常清晰：<link>里包含视觉、碰撞、惯性三个子模块；<joint>定义父子关系、相对位置和旋转轴。你想想看，整个机器人就是由这样一个个link和joint搭起来的乐高积木。

1.4 核心标签速查表

标签	作用	常用子标签
<robot>	根元素，name属性必填	link, joint, material
<link>	描述一个刚体部件	visual, collision, inertial
<joint>	描述两个link之间的运动约束	parent, child, origin, axis, limit
<visual>	可视化外观（不影响物理）	geometry, material, origin
<collision>	碰撞检测几何体	geometry, origin
<inertial>	惯性参数（质量、转动惯量）	mass, inertia

这里有个经验：很多新手只写visual，不写collision和inertial。在Rviz里看着挺漂亮，一放到Gazebo里就各种穿模、乱飘。我的建议是——从一开始就把collision和inertial写完整，哪怕用最简单的box近似，也比空着强。

1.5 知识体系一览

下面这张SVG图，把本章的核心逻辑串起来了。你可以把它当作URDF的“认知地图”。

好了，这一章咱们把URDF是什么、为什么重要、文件长什么样都过了一遍。你心里应该有个大概轮廓了。下一章我们亲手搭建开发环境，然后写出第一个能动的URDF模型。嗯，到时候你会觉得——原来这么简单。