3. 模型准备基础
说实话，我见过太多工程师在 SolidWorks 里把模型画得漂漂亮亮，结果一转到 URDF 就报错。问题出在哪？十有八九是模型准备阶段没打好基础。今天咱们就聊聊这个——坐标系、命名、装配体结构，这三样东西搞定了，后面基本一路绿灯。
3.1 坐标系规范：ROS 的“世界语言”
ROS 对坐标系有严格约定。说白了，就是大家得用同一套规则，不然机器人动起来就乱套了。
| 轴 | ROS 标准方向 | SolidWorks 默认方向 | 常见问题 |
|---|---|---|---|
| X | 向前（机器人前进方向） | 向右 | 方向不一致，导致运动学解算错误 |
| Y | 向左 | 向后 | 左右颠倒，导航路径偏移 |
| Z | 向上 | 向上 | 这个一般没问题 |
我在项目里遇到过最典型的案例：一个四轮差速底盘，SolidWorks 里 X 轴朝右，转到 URDF 后没调整坐标系。结果在 Rviz 里一跑，机器人横着走。你想想看，这要是真车，不得撞墙？
核心原则：每个零件的原点坐标系，必须与 ROS 标准对齐。X 朝前，Y 朝左，Z 朝上。这是铁律，没得商量。
3.2 零件命名规则：别给自己挖坑
命名这事，看着简单，但坑最多。我刚开始做的时候，零件名随便起，什么“Part1”、“最终版”、“改改改”。结果呢？URDF 生成的时候，一堆警告，关节对不上，link 找不到。
后来我总结了一套规则，用了五六年，再没出过命名问题：
- 全英文命名：ROS 对中文支持不好，路径里有中文直接报错。别问我怎么知道的。
- 小写字母 + 下划线：比如
base_link、left_wheel。不要用空格、连字符、大写字母。 - 名称要有语义：一眼能看出这是哪个部件。
arm_shoulder比part_001强一百倍。 - 长度控制在 20 个字符以内：太长的话，URDF 文件里写起来麻烦，调试时也不方便。
我的习惯：在 SolidWorks 里建好零件后，第一件事就是重命名。用 机器人名_部件名_功能 的格式，比如 my_robot_left_wheel。这样后面生成 URDF 时，link 和 joint 的名字自动就规范了。
3.3 装配体结构：树状层级是关键
URDF 的本质是一棵树。根节点是 base_link，然后通过关节（joint）连接各个子 link。所以你的 SolidWorks 装配体，也得是树状结构。
我见过最离谱的装配体：所有零件平铺在顶层，没有子装配体。这种结构转 URDF 基本没戏。为什么？因为 URDF 需要明确的父子关系，平铺结构没法确定关节连接顺序。
正确的做法是这样的：
- 确定根部件：通常是底盘或机身，作为
base_link。 - 按运动链分组：比如机械臂，从基座到末端，每一级关节对应一个子装配体。
- 每个关节处断开：关节两侧的零件，分别放在不同的子装配体里。
- 使用“固定”配合：同一个 link 内的零件用固定配合，关节两侧的零件用“重合”或“同轴”配合。
注意：不要在装配体里使用“镜像”或“阵列”生成零件副本。URDF 要求每个 link 有唯一的名称，镜像出来的零件名称会重复，导致转换失败。
下面这张图，是我自己画的一个装配体结构规范，你照着这个来，基本不会出错：
3.4 常见错误与避坑指南
我把自己踩过的坑整理了一下，你对照着检查，能省不少时间：
- 坐标系原点不在关节中心：URDF 的 joint 原点，必须与 SolidWorks 里配合的原点一致。我曾经有个机械臂，肩关节原点偏了 5mm，结果末端执行器位置误差累积到 3cm。
- 零件名称包含特殊字符：比如
@、#、$，ROS 解析时会直接崩溃。我建议只用字母、数字和下划线。 - 装配体层级超过 10 层：URDF 对深度没有硬性限制，但层级太深，调试时找问题非常痛苦。我一般控制在 5 层以内。
- 忘记设置“固定”配合：同一个 link 内的零件，必须用固定配合锁死。否则转 URDF 时，零件会乱飞。
我曾经... 有一次做六轴机械臂，装配体里用了“浮动”配合，结果转出来的 URDF 在 Gazebo 里直接散架。查了两天才发现是配合类型不对。从那以后，我每个配合都手动检查一遍。
3.5 快速检查清单
每次转 URDF 之前，我都会过一遍这个清单。你也试试：
| 检查项 | 要求 | 通过标准 |
|---|---|---|
| 坐标系方向 | X 朝前，Y 朝左，Z 朝上 | 与 ROS 标准一致 |
| 零件命名 | 小写 + 下划线，无中文 | 所有零件名符合规则 |
| 装配体层级 | 树状结构，不超过 5 层 | 父子关系清晰 |
| 配合类型 | 同 link 内固定，关节处重合/同轴 | 无浮动配合 |
| 零件副本 | 不使用镜像/阵列 | 每个零件唯一 |
嗯，模型准备这块，说白了就是“磨刀不误砍柴工”。你花半小时把坐标系、命名、结构理清楚，后面转 URDF 就是几分钟的事。要是偷懒跳过，后面可能花几天来排查问题。你自己选吧。