4. 将URDF导入Isaac Sim：使用Import菜单导入URDF、设置导入参数、解决导入失败问题
URDF（Unified Robot Description Format）是机器人界的通用语言。说白了，它就是一份描述机器人长什么样、关节怎么动的XML文件。但Isaac Sim并不直接吃URDF，它需要你把URDF转成自己能懂的USD格式。
这一步，我见过太多人卡在这里了。明明URDF在Rviz里跑得好好的，一进Isaac Sim就报错。别急，咱们一步步来。
4.1 导入前的准备工作
在点那个Import按钮之前，有几件事你得先确认好。我个人的习惯是列个清单，逐项打勾。
| 检查项 | 要求 | 常见问题 |
|---|---|---|
| URDF文件格式 | 标准URDF，无语法错误 | 缺少闭合标签、属性值未加引号 |
| STL/DAE网格文件路径 | 使用相对路径或package://格式 | 路径导致Isaac Sim找不到文件 |
| 关节类型 | 支持revolute、prismatic、fixed、continuous | 使用了planar或floating类型会报错 |
| 坐标系 | 所有link的坐标系定义清晰 | 原点偏移导致模型飞出去 |
| 材质引用 | 材质名称与网格文件对应 | 材质丢失导致模型变灰 |
check_urdf工具跑一遍。这个工具会告诉你URDF里有没有语法错误。命令很简单：check_urdf your_robot.urdf。如果它输出一堆绿色提示，那基本稳了。
4.2 使用Import菜单导入URDF
准备工作做完了，咱们开始正式导入。Isaac Sim的导入入口藏得不算深，但第一次用的人可能会找一会儿。
- 打开Isaac Sim，等待Stage加载完成。
- 点击顶部菜单栏的 File → Import，或者直接按快捷键
Ctrl+I。 - 在弹出的文件选择器中，将文件类型筛选改为 URDF (*.urdf)。
- 选中你的URDF文件，点击 Open。
嗯，到这里还没完。Isaac Sim会弹出一个导入参数配置窗口。这个窗口里的选项，直接决定了你的模型能不能正常用。
4.3 设置导入参数
导入参数配置窗口，说白了就是让你告诉Isaac Sim：你的URDF是怎么写的，它该怎么理解。我见过有人直接点OK，结果模型导入后关节全乱套了。
下面这张图是我自己整理的导入参数决策流程，你照着走基本不会出错。
下面我把几个关键参数拆开来讲。
4.3.1 网格文件路径设置
这是最容易出问题的地方。URDF里引用网格文件时，很多人习惯写路径，比如/home/user/robot/meshes/link1.stl。但Isaac Sim在导入时，如果找不到这个路径，就会直接报错。
正确的做法：
- 在URDF中使用
package://格式，例如package://my_robot/meshes/link1.stl。 - 在Isaac Sim的导入窗口中，设置 Mesh Search Path 指向你的网格文件所在目录。
4.3.2 关节类型映射
Isaac Sim对关节类型的支持有限。它原生支持revolute、prismatic、fixed和continuous。但如果你用了planar或floating，它就会报错。
遇到不支持的关节类型怎么办？我的做法是：
- 把planar关节拆成两个prismatic关节加一个revolute关节。
- 把floating关节替换成6个自由度（3个prismatic + 3个revolute）。
说白了，就是手动模拟。虽然麻烦，但这是目前最靠谱的办法。
4.3.3 自碰撞设置
自碰撞（Self-Collision）这个选项，默认是关闭的。但如果你做的是多关节机械臂，我建议你打开它。
为什么？因为机械臂在运动时，各个连杆之间可能会互相穿透。打开自碰撞后，Isaac Sim会检测这些碰撞并做出物理响应。
4.3.4 物理参数配置
URDF里通常会定义每个link的质量和惯性矩阵。但说实话，很多URDF里的惯性参数都是随便填的。我曾经遇到过一台机械臂，URDF里写的质量是5kg，实际称重是12kg。用这个URDF做仿真，结果完全不准。
导入时，Isaac Sim会读取URDF里的<inertial>标签。如果发现数值明显不合理（比如惯性矩阵对角线元素为0），它会自动用默认值替换。
我的建议：
- 导入前，先确认URDF里的物理参数是否准确。
- 如果不确定，可以在导入后手动调整。在Isaac Sim的Stage面板里选中对应link，在Property面板里修改mass和inertia。
4.4 解决导入失败问题
导入失败，是大家遇到最多的问题。我把常见的失败原因和解决办法整理成了表格，你遇到问题时可以直接对照排查。
| 错误现象 | 可能原因 | 解决办法 |
|---|---|---|
| 导入后Stage为空 | URDF文件路径错误或格式不合法 | 用check_urdf检查语法；确认文件路径无中文或空格 |
| 模型显示为灰色方块 | 网格文件路径错误或格式不支持 | 检查Mesh Search Path；确认STL/DAE文件可读 |
| 关节无法运动 | 关节类型不支持或joint limits缺失 | 将planar/floating改为组合关节；补全<limit>标签 |
| 模型飞出去 | base_link坐标系偏移或物理参数异常 | 将base_link的origin归零；检查质量是否过大 |
| 导入时报错"Failed to parse URDF" | URDF文件编码问题或包含非法字符 | 用UTF-8编码保存URDF；删除注释中的特殊符号 |
| 物理仿真时模型抖动 | 惯性矩阵数值异常或碰撞形状不匹配 | 手动修正惯性矩阵；使用凸包碰撞形状替代网格碰撞 |
meshlab或blender把STL转成ASCII格式，或者直接换成DAE格式。从那以后，我所有网格文件都统一用DAE格式，再没出过问题。
4.5 导入后的验证
导入成功后，别急着高兴。你得验证一下模型是不是真的能用了。我一般会做三件事：
- 检查模型结构： 在Stage面板里展开模型，确认所有link和joint都正确生成。
- 手动拖动关节： 在Viewport里选中一个关节，用鼠标拖动它，看看运动是否顺畅。
- 运行物理仿真： 点击Play按钮，让物理引擎跑起来。观察模型是否会因为重力而下落，关节是否会在重力作用下自然下垂。
如果这三步都通过了，恭喜你，你的URDF已经成功导入Isaac Sim了。