第2章 · MJCF建模实操：把样机搬进试车场

第 2 章 · MJCF 建模实操：把样机搬进试车场

本章要回答的三个问题：一份 MJCF 文件到底由哪些部分组成，引擎加载时对它做了什么？刚体、关节、几何体如何组织成一棵引擎能求解的运动学树？关节、约束、执行器这些「动力接口」该怎么配置，才能让模型不只是 statically 摆着、而是能被驱动着干活？最后一问收尾：把四节知识串起来，一台真实机械臂从 XML 到稳定运行要走哪些路？四个问题分别落在 2.1 到 2.4。

为什么会有这一章

第一章确认了「该用 MuJoCo」，紧接着的现实问题是：模型从哪来。去模型库下载一个现成的当然可以，但只要你开始改连杆长度、换夹爪、加传感器——迟早要亲手改 MJCF。这时候最常见的翻车姿势有两种：一种是把 MJCF 当普通 XML 硬背标签，照着别人的文件东抄西凑，改一个参数爆一个错；另一种是上来就用可视化编辑器拖拽，文件长什么样完全不知道，出了问题两眼一抹黑。

两种姿势的共同病根，是把建模语言当成了「格式」，而不是「契约」。MJCF 的每个标签都在向引擎承诺一件事：这棵运动学树拓扑合法、这些惯性参数物理可信、这些执行器范围不越界。引擎在加载瞬间会把这些承诺全部验一遍，任何一条不满足都会给出带行号的报错。理解了这一点，学习路径就清晰了：先搞懂文件的分层结构（2.1），再理解这棵树为什么必须长成树（2.2），然后给树装上动力接口（2.3），最后完整走一遍实战（2.4）。

还有一层现实原因：MJCF 的报错信息质量很高，但前提是你知道它在检查什么。见过太多人被一句「mass and inertia of moving bodies must be larger than mjMINVAL」劝退，其实这句话背后是引擎在保护你——惯量接近零的刚体会让质量矩阵病态，数值上等于让求解器除以零。这类「报错即在讲物理」的例子本章会反复出现，看懂它们，调模型的效率会翻倍。

读完能解决什么

对照开头几问，读完本章你应当能够：

• 独立写出一份结构完整的 MJCF：compiler、option、asset、worldbody 各司其职，加载一次通过；
• 面对任何一份现成模型，画出它的运动学树草图，指出哪个 body 是根、每级关节贡献了几个自由度；
• 为关节选对类型与限位，为任务选对执行器类型——电机、位置伺服还是肌肉模型，各有各的主场；
• 用 equality 约束拼出闭环机构，知道它能做什么、代价是什么；
• 把一台六轴机械臂从零建出来：从 CAD 数据的单位换算，到惯量填充，到第一次 mj_step 前的自检清单。

各节怎么分工

四节的依赖关系是刚性的：2.1 的分层结构是读写任何文件的地基；2.2 的运动学树是引擎世界观的核心，第三章所有动力学讨论都发生在这棵树上；2.3 在树的基础上加动力；2.4 把三者串成一条完整产线。建议按顺序读，2.4 尤其依赖前三节。

本章的全景一张图

这张图把四节的分工压进了一次加载过程：A 到 E 是 2.1 的分层结构，E 往下三格是 2.2 的树与实体，J、K 是 2.3 的动力接口，L 之后的故事交给第三章。建模时遇到报错，先对照这张图定位问题出在哪一层——是结构写错了，还是参数给错了，还是动力没接上。

先决条件

• 会 Python 基础，能读懂 XML 的嵌套写法，本章的代码示例都在这个范围内；
• 中学物理的力、质量、摩擦概念即可，2.2 涉及的惯量张量会从零讲起；
• 装好 mujoco 官方 Python 绑定：一行 pip 安装命令，加一段十行的加载验证脚本，2.1 开头会带着走；
• 手头最好有一个你真实在做的模型或项目，每节的配置清单直接往上面套。

往下走到哪

本章结束时，你手里应当有一份能稳定加载、能被驱动的机械臂模型。它此刻的行为还只是「物理上正确」，未必「数值上听话」——接触会不会抖、步长该取多大、能量会不会莫名膨胀，这些问题的答案在引擎内部。下一章掀开机盖：多刚体动力学怎么算、接触约束怎么解、mjModel 与 mjData 两本账各记什么。懂了原理，第六章的调参才有方向感。