3、MuJoCo引擎安装：从官网下载到环境配置

MuJoCo的安装，说白了就是把引擎的二进制文件放到你电脑上，再告诉系统「它在这儿」。听起来简单，但我见过太多人在这一步卡住——不是下载错了版本，就是环境变量没配好。

我个人习惯先把所有平台的安装步骤理清楚，再动手。这样心里有底，不会装到一半发现「咦，我是不是少了个文件？」。

3.1 从官网下载MuJoCo二进制文件

MuJoCo的官方下载地址是：https://mujoco.org/download。你进去后会看到一堆版本号，别慌，选最新的稳定版就行。

我记得有一次帮同事排查问题，他下载了「mujoco-3.1.6-linux-x86_64.tar.gz」，结果死活跑不起来。后来发现他系统是ARM架构的——嗯，这里要注意，一定要选对架构。

操作系统 架构 下载文件名示例
Linux x86_64 mujoco-3.1.6-linux-x86_64.tar.gz
Linux ARM64 mujoco-3.1.6-linux-aarch64.tar.gz
Windows x86_64 mujoco-3.1.6-windows-x86_64.zip
macOS ARM64 (Apple Silicon) mujoco-3.1.6-macos-arm64.zip
macOS x86_64 (Intel) mujoco-3.1.6-macos-x86_64.zip
⚠️ 版本陷阱： MuJoCo 2.x 和 3.x 的API有较大差异。如果你跟着网上老教程用2.x的API去调用3.x的库，会直接报错。我建议统一用3.x系列，目前最新稳定版是3.1.6。

3.2 Linux下的安装步骤

Linux下安装MuJoCo，我个人觉得是最顺手的。终端敲几行命令就搞定。

  1. 解压文件：把下载的 mujoco-3.1.6-linux-x86_64.tar.gz 解压到 ~/.mujoco 目录下。
mkdir -p ~/.mujoco
tar -xzf mujoco-3.1.6-linux-x86_64.tar.gz -C ~/.mujoco
  1. 验证目录结构：解压后，~/.mujoco/mujoco-3.1.6/ 下应该有 bin、include、lib、model 等文件夹。
ls ~/.mujoco/mujoco-3.1.6/
# 输出示例：bin  doc  include  lib  model  plugin
  1. 测试运行：直接跑一下MuJoCo自带的测试程序。
~/.mujoco/mujoco-3.1.6/bin/simulate ~/.mujoco/mujoco-3.1.6/model/humanoid.xml

如果弹出一个窗口，显示一个人形机器人，那就说明安装成功了。

💡 小技巧： 我在项目中遇到过，有些Linux发行版缺少 libglfw 或 libglew，会导致simulate打不开。用包管理器装上就行：sudo apt install libglfw3 libglew-dev。

3.3 Windows下的安装步骤

Windows下安装，说白了就是解压+配路径。但Windows的路径分隔符和Linux不一样，容易踩坑。

  1. 解压文件：把 mujoco-3.1.6-windows-x86_64.zip 解压到 C:\Users\你的用户名\.mujoco\mujoco-3.1.6。

我个人习惯用 %USERPROFILE%\.mujoco\mujoco-3.1.6 这个路径，这样不同用户登录时不会冲突。

  1. 验证目录结构：确保 bin 文件夹里有 simulate.exe、libmujoco.dll 等文件。
dir %USERPROFILE%\.mujoco\mujoco-3.1.6\bin
# 应该能看到：simulate.exe, libmujoco.dll, mujoco.dll 等
  1. 测试运行：双击 simulate.exe，或者用命令行启动。
%USERPROFILE%\.mujoco\mujoco-3.1.6\bin\simulate.exe %USERPROFILE%\.mujoco\mujoco-3.1.6\model\humanoid.xml
⚠️ Windows特别提醒： 我曾经遇到过，Windows Defender把 simulate.exe 误报为病毒。如果你双击没反应，先去安全中心看看是不是被隔离了。添加排除项即可。

3.4 macOS下的安装步骤

macOS的安装，其实和Linux很像。但要注意Apple Silicon和Intel芯片的版本区别。

  1. 解压文件：把 mujoco-3.1.6-macos-arm64.zip 解压到 ~/.mujoco。
mkdir -p ~/.mujoco
unzip mujoco-3.1.6-macos-arm64.zip -d ~/.mujoco
  1. 验证目录结构：和Linux一样，检查 bin、lib 等文件夹是否存在。
  1. 测试运行：
~/.mujoco/mujoco-3.1.6/bin/simulate ~/.mujoco/mujoco-3.1.6/model/humanoid.xml

如果提示「无法打开，因为无法验证开发者」，去「系统偏好设置 → 安全性与隐私 → 通用」里点「仍要打开」。

💡 macOS用户注意： 我建议用Homebrew安装依赖，省心：brew install glfw glew。不然simulate可能会因为缺少动态库而闪退。

3.5 环境变量配置

环境变量配置，是MuJoCo安装中最容易出问题的一步。你想想看，系统找不到MuJoCo的库文件，你的Python或C++程序就会报错「无法加载动态库」。

配置的核心就两个变量：LD_LIBRARY_PATH（Linux/macOS）或 PATH（Windows），以及 MUJOCO_PATH（可选，但推荐）。

3.5.1 Linux/macOS：配置 LD_LIBRARY_PATH

把MuJoCo的 lib 目录加到 LD_LIBRARY_PATH 里。我个人习惯把配置写在 ~/.bashrc 或 ~/.zshrc 里。

# 打开配置文件
nano ~/.bashrc

# 在文件末尾添加
export MUJOCO_PATH=$HOME/.mujoco/mujoco-3.1.6
export LD_LIBRARY_PATH=$MUJOCO_PATH/lib:$LD_LIBRARY_PATH

# 保存退出后，刷新配置
source ~/.bashrc

验证配置是否生效：

echo $LD_LIBRARY_PATH
# 应该能看到 /home/你的用户名/.mujoco/mujoco-3.1.6/lib

3.5.2 Windows：配置 PATH

Windows下，把MuJoCo的 bin 目录加到系统 PATH 里。

  1. 右键「此电脑」→「属性」→「高级系统设置」→「环境变量」。
  2. 在「系统变量」中找到 Path，双击编辑。
  3. 点击「新建」，添加 %USERPROFILE%\.mujoco\mujoco-3.1.6\bin。
  4. 点击「确定」保存。

验证方法：打开新的命令提示符，输入 simulate，如果能启动，说明配置成功。

📌 核心要点：
  • Linux/macOS配 LD_LIBRARY_PATH，指向 lib 目录
  • Windows配 PATH，指向 bin 目录
  • 配完后一定要 重新打开终端 或 重启IDE，否则不生效

3.6 安装验证与常见问题

装完别急着走，跑个完整的验证流程，确保所有组件都能正常工作。

3.6.1 验证流程

  1. 验证simulate可执行文件：能打开GUI窗口，加载模型。
  2. 验证动态库可被加载：用 ldd（Linux）或 otool -L（macOS）检查 libmujoco.so 的依赖是否完整。
# Linux
ldd ~/.mujoco/mujoco-3.1.6/lib/libmujoco.so

# macOS
otool -L ~/.mujoco/mujoco-3.1.6/lib/libmujoco.dylib
  1. 验证Python绑定（如果你用Python）：
python -c "import mujoco; print(mujoco.__version__)"

如果能打印出版本号，说明MuJoCo的Python接口也装好了。

3.6.2 常见问题速查

问题现象 可能原因 解决方案
simulate: command not found 环境变量没配好 检查 LD_LIBRARY_PATH 或 PATH 是否包含MuJoCo目录
error while loading shared libraries 缺少依赖库（如libglfw） 用包管理器安装缺失的库
ImportError: libmujoco.so: cannot open shared object file Python找不到MuJoCo库 确保 LD_LIBRARY_PATH 已配置，且Python环境是64位
simulate闪退 显卡驱动或OpenGL问题 更新显卡驱动，或尝试用 MESA_GL_VERSION_OVERRIDE=3.3 运行
⚠️ 架构不匹配： 我曾经帮一个朋友排查，他下载了ARM64的版本，但系统是x86_64的。结果就是所有动态库都加载失败。下载前一定先确认 uname -m 的输出。

3.7 本章知识结构

下面这张图，把MuJoCo引擎安装的完整流程和关键节点串起来了。你可以对照着检查自己有没有遗漏。

MuJoCo引擎安装流程 MuJoCo引擎安装流程 1. 官网下载二进制文件 2. 选择操作系统 Linux Windows macOS 3. 解压到 ~/.mujoco 4. 配置环境变量 5. 运行simulate验证 💡 关键检查点 • 架构匹配（x86_64/ARM） • 依赖库完整（glfw/glew） • 环境变量生效 • Python绑定可导入

这张图把安装流程分成了5步：下载 → 选平台 → 解压 → 配环境变量 → 验证。每一步都有对应的操作系统差异，但核心逻辑是一样的。

嗯，到这里MuJoCo引擎的安装就全部讲完了。你按照这个流程走一遍，应该不会出大问题。如果遇到报错，先对照「常见问题速查」表看看，大部分坑我都帮你踩过了。

← 上一章 📖 返回目录 下一章 →