【ros2】从零认识URDF：机器人模型描述的“说明书”

从零认识URDF：机器人模型描述的“说明书”

对于刚踏入机器人领域的小白来说，想要让机器人在仿真环境里动起来、在可视化工具里“显形”，第一步就是要给机器人写一份“数字说明书”——这就是URDF的核心作用。URDF（Unified Robot Description Format），即统一机器人描述格式，是ROS（包括ROS2）中专门用于描述机器人几何形状、运动学特性、动力学属性的XML格式文件。可以说，没有URDF，机器人就只是一堆没有“身份”的零件。本文将从URDF的核心作用、基本结构、关键组件到实战编写，带你从零吃透URDF。

一、URDF到底是什么？能做什么？

1. 核心定位：机器人的“数字孪生说明书”

你可以把URDF想象成一份给计算机看的机器人说明书，里面写清楚了：

• 机器人由哪些零件组成：比如底座、机械臂关节、车轮，这些零件在URDF里被称为连杆（link）；
• 零件之间如何连接：比如哪个关节能旋转、哪个关节是固定的，这些连接关系被称为关节（joint）；
• 每个零件长什么样、有多重：比如底座是立方体还是圆柱体、质量多少、会不会和其他零件碰撞；
• 零件的运动规则：比如旋转关节能转多大角度、移动关节能伸多长。

2. URDF的四大核心功能

对于ROS2入门者来说，掌握URDF就是掌握了机器人开发的“入门钥匙”，它主要支撑四大场景：

小提醒：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>