MuJoCo 安装教程：Ubuntu 环境下的完整配置与避坑指南

摘要本文详细介绍 MuJoCo 物理引擎在 Ubuntu 系统上的完整安装流程涵盖硬件要求、Release 包下载、解压测试、环境变量配置以及基于 Conda 的 Python 环境搭建。通过分步操作演示与常见问题提示帮助读者快速完成 MuJoCo 的本地部署并验证安装是否成功。一、MuJoCo 介绍MuJoCoMulti-Joint dynamics with Contact是由 Google DeepMind 开源维护的通用物理仿真引擎广泛用于机器人控制、强化学习和动画仿真等领域。它支持多关节动力学建模、接触检测与求解具有计算高效、精度高的特点是许多科研与工程项目的首选仿真工具。二、安装的硬件要求MuJoCo 对硬件要求相对友好普通开发机即可流畅运行。建议配置如下操作系统Windows、macOS 或 Linux本文以 Ubuntu 为例。CPU支持 64 位架构x86_64 或 ARM64多核处理器更佳。内存建议 8GB 及以上复杂仿真场景建议 16GB。显卡非必需但使用 MuJoCo 可视化窗口时支持 OpenGL 3.3 以上的显卡可提升渲染体验。磁盘空间预留至少 2GB 空间用于安装包与仿真资源。三、安装步骤1. 下载 MuJoCo 包本文采用直接下载 Release 包的方式安装。访问官方 GitHub 发布页面Releases · google-deepmind/mujoco · GitHub笔者系统为 Ubuntu选择对应 Linux 版本下载。系统分为 Windows、macOS、Linux 三类Ubuntu 属于 Linux可在终端使用uname -m命令查询系统架构x86_64 或 aarch64。下载包后缀的 sha256 文件用于校验包完整性当安装出现问题怀疑包损坏时可使用该文件进行校验。2. 将包提取到对应文件夹鼠标右键单击压缩包选择「提取到」并指定目标文件夹。解压后文件夹名称较长建议重命名为mujoco便于后续路径配置。3. 测试运行进入解压后的文件夹在/bin目录下运行simulate可执行文件cd mujoco/bin ./simulate出现如下仿真窗口界面说明安装包本身没有问题4. 配置环境变量需要将 MuJoCo 的库路径添加到系统环境变量中这是让系统能找到 MuJoCo 库文件的关键一步。使用文本编辑器如 gedit打开用户环境配置文件~/.bashrcsudo gedit ~/.bashrc在文件末尾添加以下行请根据实际解压路径修改export LD_LIBRARY_PATH$LD_LIBRARY_PATH:/home/ubuntu/.mujoco/mujoco310/bin保存并关闭文件后使配置立即生效source ~/.bashrc5. 使用 Conda 创建环境并安装 MuJoCo一般建议使用 Conda 建立独立环境再通过 pip 安装 MuJoCo 的 Python 绑定# 1. 创建名为 mujoco_env 的新环境指定 Python 3.10 conda create -n mujoco_env python3.10 -y 2. 激活该环境 conda activate mujoco_env 3. 升级 pip 到最新版避免安装旧版依赖 pip install --upgrade pip 4. 安装 MuJoCo Python 绑定自动包含核心引擎 pip install mujoco 5. 可选安装常用可视化和科学计算库 pip install numpy matplotlib glfw6. 验证安装在激活的环境中运行以下命令若弹出 MuJoCo 查看器窗口则说明安装成功python -m mujoco.viewer四、总结与避坑提示本文从下载 Release 包、解压测试、配置环境变量到创建 Conda 环境完整演示了 MuJoCo 在 Ubuntu 上的安装流程。以下是常见问题与避坑建议路径写错配置LD_LIBRARY_PATH时务必使用实际解压路径建议先重命名文件夹为mujoco再配置。架构不匹配下载前用uname -m确认系统架构避免下载错误版本。环境变量未生效修改~/.bashrc后必须执行source ~/.bashrc或重新打开终端。Python 版本过低建议使用 Python 3.10 及以上版本避免依赖兼容问题。校验包完整性若运行异常可使用下载页提供的 sha256 文件校验安装包是否损坏。