1 · URDF基础认知
什么是URDF？为什么机器人建模需要它？ 这一章我们先把地基打牢。
我最早接触URDF是在一个移动机器人项目里。当时团队用SolidWorks画了很漂亮的三维模型，但一放到ROS里就完全动不了——没有关节、没有坐标系、没有物理属性。说白了，那只是一堆好看的“雕塑”。后来我才明白，机器人建模的核心不是外观，而是结构描述。URDF就是干这个的。
🤖 什么是URDF？
URDF（Unified Robot Description Format）是ROS生态里用来描述机器人结构的XML语言。你可以把它理解成机器人的“骨架说明书”——告诉计算机：你有几个肢体（link），它们之间怎么连接（joint），每个部件的尺寸、质量、颜色甚至碰撞形状是什么。
一句话总结： URDF = 机器人的“身份证” + “体检表” + “装配图”。
我习惯把URDF比作乐高说明书。你想想看，如果没有图纸，给你一堆零件你也拼不出一个能动的机器人。URDF就是那张图纸，只不过它是写给Gazebo、Rviz、MoveIt这些工具看的。
⚙️ 为什么机器人建模需要URDF？
- 仿真与实物统一 —— 我在一个项目里踩过坑：实物机器人能走，但仿真里一跑就穿模。后来发现是URDF里碰撞模型没写对。URDF保证了“虚拟”和“真实”用同一套参数。
- 运动学与动力学计算 —— 没有URDF，你就没法让机械臂自动规划路径。关节角度、连杆长度、旋转轴方向……这些数据都写在URDF里。
- 可视化与调试 —— Rviz里能直接看到机器人模型，关节动一动，整个树结构都跟着动。这种直观反馈，我当年调试底盘时帮了大忙。
- 多工具链支持 —— 从导航到抓取，从SLAM到运动规划，几乎所有ROS工具都认URDF。你只要写一次，到处能用。
💡 个人经验： 刚开始学的时候别纠结于“完美模型”。先搭一个能动的骨架，再慢慢加细节。我曾经花了两天调一个轮子的颜色，结果发现关节方向反了……得不偿失。
📁 URDF文件结构概览
一个标准的URDF文件，本质上是一个XML树。根标签是 <robot>，里面包含若干 <link> 和 <joint>。我画了一张图，帮你一眼看清结构：
来看一个最简的URDF例子——一个单连杆机器人（其实就是个“铁块”）：
<?xml version="1.0" encoding="utf-8"?>
<robot name="my_first_robot">
<link name="base_link">
<visual>
<geometry>
<box size="0.2 0.2 0.1"/>
</geometry>
<material name="blue">
<color rgba="0 0.5 1 1"/>
</material>
</visual>
</link>
</robot>这个文件定义了一个叫 base_link 的连杆，视觉上是一个蓝色盒子。虽然它没有关节，但已经是一个合法的URDF模型了。你可以在Rviz里把它显示出来。
⚠️ 注意： URDF里
<robot> 标签的 name 属性不能省略。我见过有人漏掉这个，结果Gazebo直接报错不加载。另外，所有标签都是小写，属性值用双引号。
📋 核心标签速查表
| 标签 | 作用 | 出现次数 |
|---|---|---|
| <robot> | 根元素，包裹所有描述 | 1次 |
| <link> | 定义刚体部件（底盘、轮子、手臂…） | 至少1个 |
| <joint> | 定义两个link之间的连接与运动 | 0~N个 |
| <geometry> | 设置形状（box, cylinder, sphere, mesh） | 每个visual/collision内1次 |
| <material> | 颜色或纹理 | 可选 |
| <origin> | 相对坐标偏移与旋转 | 常用 |
🔧 避坑指南： 我曾经在写joint时把
xyz 和 rpy 的顺序搞反，结果机械臂直接拧成了麻花。记住：xyz 是平移，rpy 是旋转（roll, pitch, yaw）。先平移再旋转，顺序别乱。
嗯，这一章的内容差不多就是这些。URDF看起来简单，但它是后面所有章节的基石。你想想看，如果没有这个“骨架说明书”，机器人仿真、导航、规划全都无从谈起。我个人觉得，花时间把URDF的结构吃透，比急着写几百行代码更重要。