Skip to content
DroidFlight Wiki

MuJoCo 物理仿真器

概念速览

  • MuJoCo (Multi-Joint dynamics with Contact)：由 Google DeepMind 维护的开源物理引擎
  • 核心优势：接触动力学精确（无穿透、摩擦稳定），适合机器人
  • 当前版本：3.3.x (2024+)

核心特性

  • 广义坐标 (Generalized Coordinates)：不基于 3D 刚体铰链，能表达闭环 / 并联机构
  • 凸碰撞 (Convex Collision)：基于 GJK / EPA 的精确接触求解
  • 可微物理 (Differentiable Physics)：通过 mujoco-mjx JAX 后端支持梯度传播
  • MJCF / XML 建模：声明式场景描述，与 URDF 双向转换

安装与版本

Terminal window
# 原生 Python 绑定
pip install mujoco


# GPU 加速 (JAX 后端, 推荐 RL)
pip install mujoco-mjx

强化学习生态

框架集成方式特点
Gymnasium + MuJoCogymnasium.make("HalfCheetah-v4")入门最广
MuJoCo MPCC++ 实时控制器模型预测控制
BraxJAX 全栈 RL超大规模并行
MJXGPU 并行万级环境实例
Isaac Lab + MuJoCoNVIDIA 包装跨平台对比

机器人模型库

  • MuJoCo Menagerie：DeepMind 官方维护 30+ 机器人 (Franka、Unitree、ALOHA)
  • mjcf 转换工具：mujoco Python SDK 自带 URDF 导入

典型工作流

import mujoco
from mujoco import viewer


# 加载模型
model = mujoco.MjModel.from_xml_path("franka_emika_panda/scene.xml")
data = mujoco.MjData(model)


# 启动交互式查看器
viewer.launch(model, data)

与 Isaac Sim 对比

维度MuJoCoIsaac Sim
接触精度⭐⭐⭐⭐⭐⭐⭐⭐⭐
GPU 并行⭐⭐⭐ (MJX)⭐⭐⭐⭐⭐
USD 场景❌✅
RTX 光线追踪❌✅
学习曲线平缓陡峭
授权Apache 2.0NVIDIA 商业 / 学术免费

📋 复现条件

类别必备可选 / 备注
硬件任意 x86_64 / ARM64 · 8GB RAMGPU 加速 (MJX) 需 RTX 30+
操作系统Ubuntu / macOS / WindowsWSL2 跑 Linux build
软件版本Python 3.10+ · mujoco 3.2+ · mujoco-py 2.1+ (legacy)mujoco-mjx (GPU)
网络联网 (pip install)—
时间装环境 5 min · 第一个 sim 10 min · RL 训练 2 h大规模并行 1 天
难度⭐⭐ 入门XML 建模直观
前置知识Python · 强化学习 / 机器人学—

⛔ 别这么做 (Anti-patterns)

经验证的坑 —— 跳过 = 至少浪费半天，严重的烧板 / 锁机。

❌ 错误做法💥 后果⚠️ 风险范围
不要在没装 NVIDIA 驱动 555+ 的情况下跑 Isaac Sim 4.2+驱动不匹配 = 启动黑屏。nvidia-smi 查驱动版本。🔴Isaac Sim / Isaac Lab
不要把 OpenVLA / Octo / Pi-0 在没 4-bit 量化的状态下塞进 24GB 40907B 模型 fp16 = 14GB+KV cache → OOM。先 bitsandbytes 4-bit 加载再 fine-tune。🟡OpenVLA / Octo / Pi-0
不要在 Isaac Sim 训练 RL 时不设 num_envs 上限贪心 8192 envs = 24GB 显存瞬间爆。RTX 4090 实测 4096 envs 是甜点。🟡Isaac Lab / RSL-RL / SkyRL
不要在真机部署 VLA 之前跳过仿真域随机化sim-to-real gap 不收敛 = 99% 仿真成功率 + 0% 真机。先 DR 20% (质量 / 摩擦 / 视觉)。🔴任何 VLA 真机部署
不要把 3DGS 训练数据直接用手机 4K 视频4K 60fps 1 小时 ≈ 100GB，且相机畸变 = 训练出来模糊。先 ffmpeg 1080p + 标定。🟡3D Gaussian Splatting
不要在没 GPU 的 Linux 容器里跑 VLA 微调CPU 跑 7B = 1 步 5 分钟，1 epoch = 3 天。最低 1×RTX 4090 或租云。🔴OpenVLA / VLA 微调
不要用 MuJoCo 默认 simulator 跑 Mobile ALOHA 仿真默认 scene 没有双臂 + 移动底盘。要用 aloha_sim 官方 scene 文件。🟡MuJoCo / ALOHA

🚨 风险总览 (Risk Matrix)

风险等级含义例子
🟢 低改错可回滚 / 几分钟恢复pip 全局装包、DHCP IP 写死
🟡 中需要重新刷机 / 重装 / 1-2 小时恢复装错 ROS 2 版本、没 OTA 升级看版本
🔴 高不可逆 / 烧板 / 安全风险电池反接、micro-ROS 没看门狗、刷机中途断电

参考资料