企业官网建设流程全解析

MuJoCo Python 绑定：5 分钟跑通第一次物理仿真

【免费下载链接】mujocoMulti-Joint dynamics with Contact. A general purpose physics simulator.项目地址: https://gitcode.com/GitHub_Trending/mu/mujoco

第一次想用 MuJoCo 做仿真，却不想碰 C 语言、不想调编译？MuJoCo Python 绑定（MuJoCo 全称 Multi-Joint dynamics with Contact）就是那条捷径。它把 C 语言写的物理内核打包成了标准 Python 包，你不用再跟动态库较劲，几行代码就能让一个带关节、带碰撞的场景动起来。

这篇文章不打算铺陈所有接口，而是按「先看懂、再跑通、最后能自己改」的顺序，给你一条能直接落地的上手路径。全程十分钟级别。

🧭 心智模型：先分清图纸和现场

这一节帮你解决「看到一堆 MjModel、MjData 不知道谁是谁」的问题。在 MuJoCo Python 绑定里，这两个对象几乎每行代码都会碰到。

MjModel是图纸：几何体、关节、质量这些「不会变」的东西都画在上面。MjData是现场：同一张图纸，机器人此刻站哪、速度多少，这些「每帧都在变」的状态存在这里。一个 MjModel 可以配无数个 MjData，相当于同一张图纸反复开工、随时存档重来。

安装与最小可运行代码

这一节帮你解决「MuJoCo 安装这一步到底敲什么」的问题。

MuJoCo Python 绑定发布在 PyPI 上，终端里跑一条pip install mujoco就装好，依赖也一起带齐，不用额外下载任何东西。装完，最小可运行代码就下面这么长：

import mujoco xml = """ <mujoco> <worldbody> <geom name="brick" type="box" size="0.15 0.1 0.05" rgba="0.8 0.3 0.2 1"/> <geom name="orb" pos="0.35 0 0.06" type="sphere" size="0.05" rgba="0.2 0.5 0.8 1"/> </worldbody> </mujoco> """ model = mujoco.MjModel.from_xml_string(xml) data = mujoco.MjData(model) mujoco.viewer.launch(model, data)

from_xml_string从字符串读模型；如果你有一个现成的.xml文件，换成mujoco.MjModel.from_xml_path("路径")就行，两种加载方式后面都会用到。

📊 可视化怎么选：三种查看器对比

这一节帮你解决 MuJoCo 可视化里「想看到画面时该调哪个函数」的问题。

托管查看器会占住你的主线程，画面里能动、能用鼠标转视角，最省事；被动查看器反过来，把控制权交还给你的代码，你写while循环、它负责刷新画面。写脚本、录数据、接强化学习，基本都走被动这一路。

⚡ 进阶能力速览

这一节帮你解决「上手之后还能玩什么」的问题，四个能力各说三句。

命名访问：不想记编号可以按名字取。data.geom("orb").xpos直接给出那个球的位置；mujoco.mj_name2id(model, mujoco.mjtObj.mjOBJ_GEOM, "orb")则把名字换成编号，名字版更省心。

MjSpec 动态建模：不想手写 XML 也能造模型。spec = mujoco.MjSpec()之后，spec.worldbody.add_body()加一个刚体、再add_geom()挂上球或盒子，最后spec.compile()编译成能仿真的 MjModel。完整玩法见 python/mjspec.ipynb。

控制回调：想在每步仿真里塞点自定义逻辑，就注册一个回调。mujoco.set_mjcb_control(fn)之后，fn 会在每个控制周期被调用一次，你在里面改data.ctrl就能驱动执行器。

离屏渲染录视频：不开窗口的渲染负责出图。with mujoco.Renderer(model) as renderer:里循环调renderer.update_scene(data)再renderer.render()，把每一帧攒成列表，用mediapy一存就是视频。

完整小案例：让人形机器人动起来

这一节帮你解决「把所有零件串成一个能跑的循环」的问题。用 MuJoCo Python 绑定跑 model/humanoid/humanoid.xml，代码不到十行：

import numpy as np model = mujoco.MjModel.from_xml_path("model/humanoid/humanoid.xml") data = mujoco.MjData(model) mujoco.mj_resetDataKeyframe(model, data, 0) with mujoco.viewer.launch_passive(model, data) as viewer: while viewer.is_running(): data.ctrl[:] = 0.3 * np.random.randn(model.nu) mujoco.mj_step(model, data) viewer.sync()

这里关节力矩是随机的，所以机器人会晃着往前挪——这正是强化学习要优化的东西。想接真实策略，把data.ctrl换成你的网络输出即可。

🛠 踩坑速查

这一节帮你解决「跑起来之后不对劲」的问题。

资源就这三个，够用：MuJoCo 教程 python/tutorial.ipynb、API 参考 doc/APIreference/index.rst、模型库 model/。

剩下的，就是打开终端、敲下那行import mujoco，让第一个场景自己动起来。

【免费下载链接】mujocoMulti-Joint dynamics with Contact. A general purpose physics simulator.项目地址: https://gitcode.com/GitHub_Trending/mu/mujoco