文章目录
- 从零认识URDF：机器人模型描述的“说明书”
- 一、URDF到底是什么？能做什么？
- 1. 核心定位：机器人的“数字孪生说明书”
- 2. URDF的四大核心功能
- 二、URDF的基本结构：XML格式的“零件清单”
- 1. 根节点：`<robot>`
- 2. 核心组件一：`<link>`——机器人的“零件”
- （1）`<visual>`：定义零件的“长相”（仅用于显示）
- （2）`<collision>`：定义零件的“碰撞边界”（物理计算用）
- （3）`<inertial>`：定义零件的“重量和惯性”（动力学计算用）
- （4）`<material>`：给零件“上色”
- 3. 核心组件二：`<joint>`——零件之间的“连接器”
- （1）基本属性：`name`和`type`
- （2）`<parent>`和`<child>`：定义连接关系
- （3）`<origin>`：定义关节的“安装位置”
- （4）`<axis>`：定义关节的“运动轴线”
- （5）`<limit>`：定义关节的“运动约束”
- 三、实战：编写一个两轮机器人的URDF
- 1. 完整URDF代码
- 2. 代码解读
- 四、URDF的语法验证：写完必做的检查步骤
- 1. 安装工具（若未安装）
- 2. 验证语法
- 3. 查看结果
- 五、小白必知的URDF常见坑
- 六、延伸：URDF的“升级版”——Xacro
- 总结
从零认识URDF：机器人模型描述的“说明书”
对于刚踏入机器人领域的小白来说，想要让机器人在仿真环境里动起来、在可视化工具里“显形”，第一步就是要给机器人写一份“数字说明书”——这就是URDF的核心作用。URDF（Unified Robot Description Format），即统一机器人描述格式，是ROS（包括ROS2）中专门用于描述机器人几何形状、运动学特性、动力学属性的XML格式文件。可以说，没有URDF，机器人就只是一堆没有“身份”的零件。本文将从URDF的核心作用、基本结构、关键组件到实战编写，带你从零吃透URDF。
一、URDF到底是什么？能做什么？
1. 核心定位：机器人的“数字孪生说明书”
你可以把URDF想象成一份给计算机看的机器人说明书，里面写清楚了：
- 机器人由哪些零件组成：比如底座、机械臂关节、车轮，这些零件在URDF里被称为连杆（link）；
- 零件之间如何连接：比如哪个关节能旋转、哪个关节是固定的，这些连接关系被称为关节（joint）；
- 每个零件长什么样、有多重：比如底座是立方体还是圆柱体、质量多少、会不会和其他零件碰撞；
- 零件的运动规则：比如旋转关节能转多大角度、移动关节能伸多长。
2. URDF的四大核心功能
对于ROS2入门者来说，掌握URDF就是掌握了机器人开发的“入门钥匙”，它主要支撑四大场景：
| 功能场景 | 具体作用 | 小白直观感受 |
|---|---|---|
| 可视化展示 | 在RViz2中显示机器人的3D模型 | 能“看见”自己设计的机器人长什么样 |
| 运动学计算 | 为机器人正逆运动学求解提供参数 | 告诉计算机“关节转10度，末端会到哪里” |
| 仿真驱动 | 为Gazebo仿真环境提供物理属性 | 让机器人在仿真里“跑起来”“动起来” |
| 路径规划 | 为MoveIt2等规划器提供几何约束 | 让机器人知道“怎么动才不会撞到自己” |
小提醒：URDF有一个局限性——只支持树形结构的机器人，简单说就是机器人的零件不能“闭环”（比如并联机器人）。如果要做闭环机器人，后续需要结合SRDF（语义机器人描述格式）扩展，这是后话，入门阶段先掌握URDF即可。
二、URDF的基本结构：XML格式的“零件清单”
URDF是纯XML文件，后缀名通常为.urdf，其核心结构就像一棵“树”：根节点是<robot>，下面挂着若干<link>（连杆）和<joint>（关节），再辅以<material>（材质）等辅助节点。
1. 根节点：<robot>
所有URDF内容都必须包裹在<robot>标签内，name属性用来定义机器人的名称（比如“my_first_robot”），这个名称要唯一，是机器人的“身份证号”。
最基础的URDF骨架：
<?xml version="1.0"?><!-- 根节点：定义机器人名称 --><robotname="my_first_robot"><!-- 下面放连杆、关节、材质等内容 --></robot>2. 核心组件一：<link>——机器人的“零件”
<link>是URDF中描述机器人刚体零件的基本单元，比如底座、车轮、机械臂的小臂，都对应一个<link>。一个完整的<link>包含三大核心子节点，分别负责“外观”“碰撞”“重量”，三者缺一不可。
（1）<visual>：定义零件的“长相”（仅用于显示）
<visual>子节点只负责机器人在RViz2中的可视化效果，不参与任何物理计算，就像给零件“穿衣服”。它包含三个关键部分：
<origin>：定义零件的局部坐标系相对于连杆原点的位姿，参数xyz表示平移（单位：米），rpy表示旋转（单位：弧度，绕x→y→z轴旋转）；<geometry>：定义零件的几何形状，支持四种基础形状+外部3D模型；<material>：定义零件的颜色，需要提前定义材质。
常见几何形状示例：
<linkname="base_link"><!-- 连杆名称：base_link（底座），全局唯一 --><visual><!-- 位姿：在原点，无旋转 --><originxyz="0 0 0"rpy="0 0 0"/><geometry><!-- 立方体：长×宽×高=0.5m×0.5m×0.1m --><boxsize="0.5 0.5 0.1"/><!-- 可选形状：圆柱体（长度×半径） <cylinder length="0.2" radius="0.1"/> --><!-- 可选形状：球体（半径） <sphere radius="0.15"/> --><!-- 可选：外部3D模型（stl/dae格式，需放在功能包的meshes目录） <mesh filename="package://my_robot/meshes/base.stl"/> --></geometry><!-- 引用材质：gray（灰色） --><materialname="gray"/></visual></link>（2）<collision>：定义零件的“碰撞边界”（物理计算用）
<collision>子节点负责机器人的碰撞检测和物理仿真，比如机器人会不会撞到桌子、车轮会不会碰到障碍物，都靠这个节点定义。
关键注意点：
<collision>的几何形状可以和<visual>不一样！比如<visual>用复杂的3D模型（好看），<collision>用简单的立方体（减少计算量），这是仿真优化的常用技巧；- 语法和
<visual>完全一致，只需要把<visual>标签换成<collision>。
示例：
<linkname="base_link"><visual>...</visual><!-- 外观是复杂模型 --><!-- 碰撞形状用简单立方体，提升仿真效率 --><collision><originxyz="0 0 0"rpy="0 0 0"/><geometry><boxsize="0.5 0.5 0.1"/></geometry></collision></link>（3）<inertial>：定义零件的“重量和惯性”（动力学计算用）
<inertial>子节点描述零件的质量和惯性矩阵，是机器人运动学、动力学计算的核心——比如关节需要多大的力才能转动、机器人加速时会有多大惯性，都靠这个节点。
对于小白来说，记住两个核心参数即可：
<mass>：零件的质量，单位是千克（kg）；<inertia>：惯性矩阵，是一个3×3的对称矩阵，参数ixx/ixy/ixz/iyy/iyz/izz分别对应矩阵的6个独立元素。
小技巧：简单形状的惯性矩阵可以用公式计算（比如立方体：
ixx = m*(y²+z²)/12），复杂形状可以用Blender、FreeCAD等工具计算，不用手动硬算。
示例：
<linkname="base_link"><visual>...</visual><collision>...</collision>
