- 类别
- 仿真与评测 · 仿真器
- 开放程度
- 开源
- 发布时间
- 2012 年
- 开源协议
- Apache-2.0
- 发布方所在地
- 英国
项目简介
通用物理引擎,全称 Multi-Joint dynamics with Contact,用于机器人、生物力学、动画和机器学习中带接触的多关节系统仿真。提供 C API、Python 绑定、Unity 插件和交互式查看器 simulate,附带用 JAX 实现的 MJX,可在 GPU / TPU 上批量并行仿真。最初由 Emo Todorov 等开发,现由 Google DeepMind 开源维护。
MuJoCo 安装要点
来源:README.md依据官方资料的 4.0.0 版本整理,核验于 2026-11-06。版本更新后命令可能变化,以官方文档为准。
安装 Python 绑定
包里自带 MuJoCo 库;从 4.0 前升级要先卸载旧版
pip install mujoco打开交互查看器来源:mujoco.readthedocs.io
python -m mujoco.viewer下载预编译包
官方推荐用 GitHub Releases 的预编译包,解压即用
运行 MuJoCo Studio来源:mujoco.readthedocs.io
Linux 写法,在解压目录的 bin 子目录运行
./mujoco_studio ../model/humanoid/humanoid.xml
环境要求
来源:README.md- Python
- 3.11 或更新(用 Python 绑定时)
- 系统
- Linux(x86-64、AArch64)、Windows(仅 x86-64)、macOS(universal)
- Linux wheel
- 目标是 manylinux2014
适配矩阵
来源:mujocoMuJoCo 4.0.0 各平台的预编译包
| 名称 | 预编译包 | 格式 |
|---|---|---|
| Linux x86-64来源:mujoco | ✓ | .tar.gz |
| Linux AArch64来源:mujoco | ✓ | .tar.gz |
| Windows x86-64来源:mujoco | ✓ | .zip |
| macOS(universal)来源:mujoco | ✓ | .dmg |
✓ 官方资料写明支持,— 资料没写,版本号照原文。没写不等于不支持。
常见报错
解法来自官方文档、维护者回复或提问者确认,部分报错出自旧版本。
gladLoadGL error原因MjrContext 本身不建立 OpenGL 上下文,无头环境下要先建好
解决用 mujoco.Renderer,或先手动创建 EGL 上下文再构造 MjrContext
来源:Issue #2458gl_context = mujoco.egl.GLContext(1024, 1024) gl_context.make_current()RuntimeError: launch_passive requires that the Python script be run under mjpython原因macOS 平台限制要求主线程负责渲染
解决在 macOS 上用 mjpython 代替 python 运行脚本
来源:mujoco.readthedocs.iomjpython my_script.pyMUJOCO_PATH environment variable is not set原因pip 没选中预编译 wheel,转去用 sdist 源码构建
解决macOS 的 conda 默认 Python 平台标识不对,先设环境变量再 pip 安装
来源:Issue #1004export SYSTEM_VERSION_COMPAT=0Pass 'Combine redundant instructions' is not initialized.原因可能是 Linux 上走了软件渲染(llvmpipe)
解决设置 MUJOCO_GL=EGL;有库先导入 PyOpenGL 时再设置 PYOPENGL_PLATFORM=egl
来源:Issue #791Illegal instruction (core dumped)原因MuJoCo 需要支持 AVX 的处理器,虚拟机可能没有开放 AVX
解决在虚拟机里开启 AVX;开不了就从源码构建并关闭 AVX
来源:Issue #487C1083 Cannot open include file: 'stdalign.h': No such file or directory解决用 MSVC 构建时用 Visual Studio 2019 或更新版本,并安装 Windows SDK 10.0.22000 或更新版本
来源:mujoco.readthedocs.io