仿真器开源

MuJoCo

Google DeepMind英国

GitHub 仓库 google-deepmind/mujoco

又称 Multi-Joint dynamics with Contact、MJX、MuJoCo XLA

类别
仿真与评测 · 仿真器
开放程度
开源
发布时间
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。版本更新后命令可能变化,以官方文档为准。

  1. 安装 Python 绑定

    包里自带 MuJoCo 库;从 4.0 前升级要先卸载旧版

    pip install mujoco
  2. 打开交互查看器来源:mujoco.readthedocs.io

    python -m mujoco.viewer
  3. 下载预编译包

    官方推荐用 GitHub Releases 的预编译包,解压即用

  4. 运行 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

适配矩阵

来源:mujoco

MuJoCo 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

gl_context = mujoco.egl.GLContext(1024, 1024)
gl_context.make_current()
来源:Issue #2458
RuntimeError: launch_passive requires that the Python script be run under mjpython

原因macOS 平台限制要求主线程负责渲染

解决在 macOS 上用 mjpython 代替 python 运行脚本

mjpython my_script.py
来源:mujoco.readthedocs.io
MUJOCO_PATH environment variable is not set

原因pip 没选中预编译 wheel,转去用 sdist 源码构建

解决macOS 的 conda 默认 Python 平台标识不对,先设环境变量再 pip 安装

export SYSTEM_VERSION_COMPAT=0
来源:Issue #1004
Pass 'Combine redundant instructions' is not initialized.

原因可能是 Linux 上走了软件渲染(llvmpipe)

解决设置 MUJOCO_GL=EGL;有库先导入 PyOpenGL 时再设置 PYOPENGL_PLATFORM=egl

来源:Issue #791
Illegal instruction (core dumped)

原因MuJoCo 需要支持 AVX 的处理器,虚拟机可能没有开放 AVX

解决在虚拟机里开启 AVX;开不了就从源码构建并关闭 AVX

来源:Issue #487
C1083 Cannot open include file: 'stdalign.h': No such file or directory

解决用 MSVC 构建时用 Visual Studio 2019 或更新版本,并安装 Windows SDK 10.0.22000 或更新版本

来源:mujoco.readthedocs.io

获取方式

相关概念

数据来源

本页信息均整理自以下公开资料。

11 条来源核验于 2026-10-01

星标、下载量等指标定期自动更新。

MuJoCo:安装步骤、环境要求与常见报错 | 具身集