Win10系统下MuJoCo 1.50与mujoco-py环境配置全攻略

1. 项目缘起：为什么在Win10上搭建MuJoCo环境这么“磨人”

如果你正在接触机器人、强化学习或者物理仿真，MuJoCo这个名字大概率已经在你耳边响过无数次了。作为目前最主流的物理仿真引擎之一，它以其出色的计算效率和物理精度，成为了OpenAI Gym、DeepMind Control Suite等众多知名研究框架的底层支柱。然而，对于绝大多数初次接触它的Windows用户来说，从零开始搭建一个可用的MuJoCo环境，其过程之曲折，足以让一个心态平和的人开始怀疑人生。

我最初接触MuJoCo是在一个机器人控制的项目上，当时团队里清一色的macOS和Linux用户，环境配置顺风顺水。轮到我这个用Windows主力开发的人时，画风就完全变了。官方的安装指南对Windows的支持语焉不详，社区里的教程要么年代久远，要么步骤跳跃，照着做十有八九会卡在某个诡异的编译错误或者动态链接库缺失的提示上。更让人头疼的是，MuJoCo本身是一个商业软件，虽然现在有免费的个人许可证，但其依赖的Python绑定库mujoco-py在Windows上的构建过程，堪称一场与编译器、系统路径和包管理器的“肉搏战”。

所以，这篇内容不是什么官方指南的复述，而是我经历了数次失败，重装了不下五遍系统环境，最终趟平了所有坑之后，总结出的一份“幸存者笔记”。我们的目标非常明确：在一台干净的Windows 10系统上，从零开始，成功安装Anaconda、MuJoCo 1.50，并让mujoco-py这个第三方库能够正常导入和使用。我会把每一步的原理、可能遇到的坑以及背后的原因都讲清楚，让你不仅能把环境搭起来，更能明白为什么需要这么做。毕竟，在AI和机器人领域，会“炼丹”的第一步，就是得先能把“丹炉”给点着火。

2. 战前准备：理清工具链与核心依赖关系

在动手敲任何命令之前，我们必须先搞清楚我们要安装的这一套东西，彼此之间到底是什么关系。这就像组装一台精密仪器，你得先认识每一个零件是干嘛的，否则对着说明书也会装错。

2.1 核心组件角色解析

首先，我们把主角们请上台：

• Anaconda： 它不是一个编程语言，而是一个强大的Python发行版和包管理环境。你可以把它想象成一个功能齐全的“科学计算工具箱”和“环境隔离舱”。它的核心价值在于两点：一是预装了海量的数据科学、机器学习相关的库（如NumPy, Pandas, Scikit-learn），省去了我们一个个手动安装的麻烦；二是提供了conda命令，可以轻松创建、管理和切换相互独立的Python虚拟环境。这意味着你可以在一个环境里用Python 3.7配老版本的TensorFlow，在另一个环境里用Python 3.10配最新的PyTorch，两者互不干扰。对于MuJoCo这种对环境要求比较“挑剔”的库，用Anaconda创建独立环境是避免系统环境被污染的最佳实践。
• MuJoCo 1.50： 这是物理仿真引擎的本体，一个用C/C++编写的、跨平台的动态链接库（在Windows上是.dll文件）。它负责最底层的物理计算，比如刚体运动、关节约束、碰撞检测等。你下载的MuJoCo实际上是一个SDK（软件开发工具包），里面包含了这些核心库文件、头文件、示例程序和文档。Python本身无法直接调用这个C++库，所以我们需要一个“翻译官”。
• mujoco-py： 它就是那个关键的**“翻译官”或“Python绑定（Binding）”库**。这是一个由OpenAI维护的第三方开源项目，它的作用是在Python代码和MuJoCo的C库之间架起一座桥梁。当你写import mujoco_py时，这个库会负责找到系统里的MuJoCo库文件（.dll），并调用其中的函数。mujoco-py还封装了许多方便的函数和类，让用Python操作MuJoCo变得非常直观。

它们三者的关系可以概括为：Anaconda为我们提供了干净、可控的“工作间”（Python环境）；在这个工作间里，我们通过mujoco-py这个工具，去指挥和调用MuJoCo这个强大的“物理引擎”进行仿真。

2.2 为什么选择MuJoCo 1.50和特定版本的mujoco-py？

你可能注意到，标题里指定了版本1.50。这不是随意选的。MuJoCo在2.0版本之后被DeepMind开源并进行了大量重构，API和部分特性发生了变化。而目前（截至我写这篇文章时），许多经典的强化学习算法库（如OpenAI Baselines、Stable-Baselines3的某些早期版本）以及大量的学术论文代码，仍然基于MuJoCo 1.5x系列。为了保证最大的兼容性，从1.50或1.52开始入手是一个稳妥的选择。mujoco-py也有对应的版本要求，通常与MuJoCo本体版本匹配。

2.3 系统环境与账号准备

在开始前，请确保你的Windows 10系统满足以下条件：

1. 系统版本： Windows 10 64位（版本1903或更高推荐）。32位系统无法运行。
2. 用户权限： 使用具有管理员权限的账户进行操作。很多安装步骤需要向系统目录写入文件或修改系统环境变量。
3. 磁盘空间： 预留至少5GB的可用空间，用于安装Anaconda、MuJoCo SDK和各种Python包。
4. 网络环境： 由于需要从GitHub、Anaconda官方源等外网地址下载资源，请确保网络通畅。后续我们会介绍如何使用国内镜像源来加速Python包的下载，但MuJoCo的许可证激活和SDK下载仍需访问其官网。

做好这些准备，我们就可以正式开工了。记住，耐心和仔细是成功配置环境的第一要素。

3. 第一步：安装与配置Anaconda

Anaconda是我们的基石，这一步走稳了，后面会省力很多。

3.1 下载与安装Anaconda

首先，访问Anaconda的官方发行商Anaconda Inc.的网站（由于避免直接提供链接，请自行搜索“Anaconda Distribution”找到官网）。在下载页面，选择适用于Windows的Python 3.x 64位图形安装包。这里有个小建议：除非你有特殊需求，否则不要选择最新的Python版本，比如Python 3.12。很多科学计算库对新版本Python的支持会有延迟。选择Python 3.8或3.9的Anaconda安装包是兼容性最好的稳妥之选。

运行下载好的.exe安装程序。安装过程中有几个关键选项需要注意：

• 安装路径： 强烈建议安装到一个没有中文和空格的路径下，例如D:\Anaconda3。很多编程工具对中文路径的支持很差，这能避免未来无数潜在的诡异错误。
• 高级选项： 务必勾选“Add Anaconda3 to my PATH environment variable”（将Anaconda3添加到我的PATH环境变量）。虽然安装程序会警告说这可能影响其他软件，但对于个人开发环境而言，勾选它会让后续在命令行中使用conda和python命令变得无比方便。同时，它也默认会勾选“Register Anaconda3 as my default Python 3.x”，这个也保持选中。

安装完成后，我们需要验证安装是否成功。按下Win + R键，输入cmd打开命令提示符，或者更好的是，在开始菜单中找到并打开“Anaconda Prompt (Anaconda3)”。这是一个已经激活了Anaconda基础环境的命令行工具，用起来更省心。

在命令行中，依次输入以下命令并回车：

conda --version python --version

如果分别显示了conda和Python的版本号（例如conda 24.x.x，Python 3.9.x），那么恭喜你，Anaconda安装成功。

3.2 配置Conda国内镜像源（加速下载）

默认情况下，conda会从国外的服务器下载包，速度可能很慢甚至失败。我们可以将其替换为国内的镜像源，例如清华大学的TUNA镜像。

继续在Anaconda Prompt中，依次执行以下命令来添加通道（channel）：

conda config --add channels https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/main/ conda config --add channels https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/free/ conda config --add channels https://mirrors.tuna.tsinghua.edu.cn/anaconda/cloud/conda-forge/ conda config --set show_channel_urls yes

这些命令会修改你的用户目录下的.condarc配置文件。执行后，你可以通过conda config --show channels来查看当前已配置的通道列表，确保清华源的地址在最上面。

注意： 网上有些老教程会提到https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/free这个通道，但在新版本的Conda仓库结构中，free和main通道可能已经合并或调整。如果你在后续安装某些包时遇到“HTTP 404 Not Found for channel anaconda/pkgs/free”的错误，可以尝试在.condarc文件中将该行注释掉或删除，只保留main和conda-forge通道。.condarc文件通常位于C:\Users\你的用户名目录下，可以用记事本打开编辑。

3.3 为MuJoCo创建独立的虚拟环境

这是Conda最棒的功能之一。我们专门为MuJoCo项目创建一个隔离的环境，避免与系统或其他项目的Python包发生冲突。

在Anaconda Prompt中，运行：

conda create -n mujoco_env python=3.8

这条命令创建了一个名为mujoco_env的新环境，并指定安装Python 3.8。你可以把mujoco_env换成任何你喜欢的名字，python=3.8也可以根据你需要调整（但强烈建议使用3.7-3.9之间的版本）。

创建完成后，激活这个环境：

conda activate mujoco_env

激活后，命令行的提示符前缀通常会从(base)变为(mujoco_env)，这表示你现在已经在这个独立的环境中了，之后所有pip install或conda install的操作都只会影响这个环境。

至此，我们的“工作间”已经准备就绪，并且配置了快速的“物流通道”（国内镜像）。接下来，我们要去获取那个强大的物理引擎本体了。

4. 第二步：获取、安装与激活MuJoCo 1.50

MuJoCo本身是商业软件，但DeepMind已提供免费的个人许可证。我们需要完成“获取许可证-下载SDK-配置系统路径”这三部曲。

4.1 获取MuJoCo许可证

1. 访问MuJoCo的官方网站（请搜索“MuJoCo”找到DeepMind旗下的页面）。
2. 在网站上找到“Download”或“Get Started”部分，它会引导你获取许可证。通常你需要用一个电子邮件地址注册，他们会将许可证文件（一个名为mjkey.txt的文本文件）发送到你的邮箱。请务必妥善保存这个文件，它是激活MuJoCo的钥匙。
3. 同时，在网站上找到MuJoCo 1.50版本（可能标注为1.50或1.5.0）的Windows预编译二进制包（通常是.zip或.msi格式）并下载。如果找不到1.50，1.52或1.55版本也可以，但需要与后续mujoco-py的版本对应。

4.2 安装MuJoCo SDK

安装MuJoCo SDK非常简单，本质上就是“解压”和“放对位置”。

1. 在你电脑上找一个合适的路径，同样要求无中文和空格。例如，在D盘根目录下创建一个文件夹，命名为MuJoCo。
2. 将下载的MuJoCo 1.50压缩包（例如mujoco150_win64.zip）解压到这个D:\MuJoCo文件夹中。解压后，你应该能看到类似bin,include,model,sample等子文件夹。
3. 将之前收到的许可证文件mjkey.txt，复制到两个位置：
   • D:\MuJoCo\mjpro150\bin（即MuJoCo的bin目录下）
   • C:\Users\你的用户名\.mujoco\（这是一个隐藏文件夹，如果不存在就手动创建它）

踩坑提醒一：路径与权限： 放在系统用户目录下的.mujoco文件夹是mujoco-py默认会去查找许可证的地方。确保你有权限创建和写入这个目录。如果遇到权限问题，可以尝试以管理员身份运行文件资源管理器或命令行。

4.3 配置系统环境变量

这是让系统和其他程序（包括待会儿要安装的mujoco-py）能够找到MuJoCo库的关键一步。

1. 在Windows搜索栏输入“环境变量”，选择“编辑系统环境变量”。
2. 点击下方的“环境变量”按钮。
3. 在“系统变量”或“用户变量”部分（建议用户变量即可），找到并选中Path变量，点击“编辑”。
4. 点击“新建”，然后添加MuJoCo的bin目录路径：D:\MuJoCo\mjpro150\bin。
5. 同样地，再新建一个系统变量（不是添加到Path）：
   • 变量名：MUJOCO_PY_MUJOCO_PATH
   • 变量值：D:\MuJoCo\mjpro150
   • 这个变量是专门给mujoco-py看的，告诉它MuJoCo的本体在哪里。
6. 一路点击“确定”保存所有更改。

4.4 验证MuJoCo基础安装

打开一个新的命令提示符（cmd）（注意，不是Anaconda Prompt，因为我们需要测试系统级的PATH是否生效），输入：

cd /d D:\MuJoCo\mjpro150\bin simulate.exe ..\model\humanoid.xml

如果配置正确，你应该会弹出一个MuJoCo的仿真查看器窗口，里面显示一个人形模型。这说明MuJoCo本体和许可证都已经正常工作。可以关掉这个窗口。

至此，物理引擎已经就位，并且系统已经知道它在哪了。接下来，我们要搭建连接Python和这个引擎的桥梁。

5. 第三步：安装与编译mujoco-py——最艰巨的一战

mujoco-py的安装是整个过程里最容易出错的地方，因为它涉及从源码编译C扩展。我们需要在之前创建好的Conda虚拟环境中操作。

5.1 激活环境并安装基础依赖

首先，打开“Anaconda Prompt (Anaconda3)”，激活我们的MuJoCo环境：

conda activate mujoco_env

接着，安装一些编译mujoco-py所必需的构建工具和库。这是避免后续编译错误的关键。

conda install -c conda-forge numpy cython patchelf

• numpy： 科学计算基础库，mujoco-py依赖它。
• cython： 用于将mujoco-py的部分Python代码编译成C，提升性能。
• patchelf： 一个Linux下常用的二进制文件修改工具，在Windows上通过conda-forge也能安装，mujoco-py的构建脚本可能会用到它来处理库路径。

此外，我们还需要Visual Studio Build Tools中的C++编译器。这是Windows上编译Python C扩展的标配。

1. 访问Visual Studio官方网站，找到“下载”->“Visual Studio 2022”->“所有下载”->“工具”->“Visual Studio 2022 生成工具”。
2. 下载并运行安装程序。在安装工作负载选择界面，务必勾选“使用C++的桌面开发”，并在右侧的“可选”组件中，确保“Windows 10 SDK”或“Windows 11 SDK”被选中。然后进行安装。

5.2 安装mujoco-py

我们不直接使用pip install mujoco-py，因为PyPI上的预编译轮子（wheel）很可能不包含对MuJoCo 1.50的支持，或者与我们的环境不兼容。最可靠的方式是从GitHub克隆特定版本的源码进行安装。

在激活的mujoco_env环境中，执行：

pip install -U pip setuptools wheel # 确保pip等工具是最新的 git clone https://github.com/openai/mujoco-py.git cd mujoco-py pip install -r requirements.txt pip install -r requirements.dev.txt # 安装必要的Python依赖

接下来是关键步骤：安装mujoco-py本身。我们需要指定它去寻找我们自定义路径下的MuJoCo。在mujoco-py目录下，执行：

python setup.py install --mujoco-path=D:\MuJoCo\mjpro150

或者，如果你已经设置了环境变量MUJOCO_PY_MUJOCO_PATH，也可以直接：

python setup.py install

这个setup.py install命令会启动编译过程。你会看到命令行中开始输出大量的编译信息。这个过程可能会持续几分钟，请耐心等待。

踩坑提醒二：编译错误大全：

• 错误：error: Microsoft Visual C++ 14.0 or greater is required： 这说明你的Visual Studio Build Tools没有正确安装或未被Python识别。请确保已安装“使用C++的桌面开发”工作负载，并尝试在“Visual Studio 2022 Developer Command Prompt”中运行上述命令。
• 错误：找不到GL/gl.h等OpenGL头文件： MuJoCo的图形渲染需要OpenGL。对于Windows，通常需要安装“Windows SDK”，其中包含了这些头文件。确保在安装VS Build Tools时勾选了Windows SDK。
• 错误：链接错误，找不到glew32.lib或其他.lib文件： 这些是预编译的OpenGL扩展库。一个常见的解决方案是手动下载GLFW和GLEW的预编译Windows二进制包，将其lib和include文件夹中的内容分别复制到VS Build Tools的库目录和包含目录中，但这非常繁琐。更简单的方法是：在mujoco-py的setup.py同级目录下，创建一个vendor文件夹，然后将MuJoCo SDK目录（D:\MuJoCo\mjpro150）下的glew和glfw子文件夹（如果存在）或整个SDK中的相关.dll、.lib文件，拷贝到vendor文件夹下，并调整setup.py中的查找逻辑。不过，mujoco-py的较新版本通常已经包含了这些依赖的副本。如果遇到此问题，可以尝试寻找针对Windows的、已打好补丁的mujoco-py分支或直接使用预编译的wheel文件（如果运气好能找到对应版本）。

5.3 验证mujoco-py安装

编译安装完成后，不要关闭当前命令行。我们进入Python交互环境进行测试：

python

在打开的Python解释器中，依次输入：

import mujoco_py import os print(os.environ.get('MUJOCO_PY_MUJOCO_PATH')) # 检查环境变量是否被识别 from mujoco_py import load_model_from_path, MjSim, MjViewer print("导入成功！")

如果没有报错，并且打印出了你的MuJoCo路径，那么恭喜你，最艰难的一关已经过了！你可以尝试加载一个模型看看：

model = load_model_from_path('D:/MuJoCo/mjpro150/model/humanoid.xml') sim = MjSim(model) viewer = MjViewer(sim) for i in range(100): sim.step() viewer.render()

如果能看到图形窗口并显示人形模型在晃动，说明一切完美。按Ctrl+C可以中断循环并退出。

6. 第四步：集成开发环境配置与终极测试

环境搭好了，我们总得在顺手的IDE里用起来。这里以PyCharm和VS Code为例。

6.1 PyCharm配置

1. 打开PyCharm，创建一个新项目或打开现有项目。
2. 进入File -> Settings -> Project: [你的项目名] -> Python Interpreter。
3. 点击右上角的齿轮图标，选择Add...。
4. 在左侧选择Conda Environment，然后选择Existing environment。
5. 在Interpreter路径中，浏览到你Anaconda安装目录下的envs\mujoco_env文件夹，选择里面的python.exe（例如D:\Anaconda3\envs\mujoco_env\python.exe）。
6. 点击确定。PyCharm会索引这个环境下的所有包，稍等片刻，你就能在解释器列表中看到mujoco_py了。

6.2 Visual Studio Code配置

1. 在VS Code中打开你的项目文件夹。
2. 按下Ctrl+Shift+P打开命令面板，输入Python: Select Interpreter并选择。
3. 在弹出的列表中，应该能看到Python 3.x.x ('mujoco_env': conda)这样的选项，选择它。
4. 你也可以在项目根目录下创建一个.vscode/settings.json文件，内容如下：

   { "python.defaultInterpreterPath": "D:\\Anaconda3\\envs\\mujoco_env\\python.exe" }

6.3 编写并运行测试脚本

在你的项目目录下，创建一个新的Python文件，例如test_mujoco.py，写入以下内容：

import sys import os # 临时添加MuJoCo的bin目录到系统路径，双重保险 sys.path.append(r'D:\MuJoCo\mjpro150\bin') os.add_dll_directory(r'D:\MuJoCo\mjpro150\bin') # Python 3.8+ 推荐使用此方法加载DLL import mujoco_py import numpy as np print(f"MuJoCo路径: {os.environ.get('MUJOCO_PY_MUJOCO_PATH')}") print(f"mujoco_py版本: {mujoco_py.__version__}") # 加载一个简单模型 model_path = os.path.join(os.environ['MUJOCO_PY_MUJOCO_PATH'], 'model', 'humanoid.xml') model = mujoco_py.load_model_from_path(model_path) sim = mujoco_py.MjSim(model) viewer = mujoco_py.MjViewer(sim) print(f"模型加载成功，自由度: {sim.data.qpos.shape[0]}") # 简单交互：让模型随机动一下 for i in range(500): # 施加随机控制信号 sim.data.ctrl[:] = np.random.randn(sim.model.nu) sim.step() viewer.render() print("测试完成！")

在配置好Conda环境的PyCharm或VS Code中运行这个脚本。你应该能看到MuJoCo的仿真窗口弹出，并且人形模型开始随机扭动，同时命令行输出相关的路径和版本信息。

如果运行成功，那么你的Win10 + Anaconda + MuJoCo 1.50 + mujoco-py开发环境就已经完全搭建成功，可以投入到真正的强化学习或机器人仿真项目中了。

回顾整个过程，核心难点在于mujoco-py的编译环节，它强烈依赖于正确的Visual C++构建工具和系统库路径。只要按照上述步骤，仔细检查路径、环境变量和依赖库，绝大多数问题都能被解决。这套环境就像一台精密的仪器，每个螺丝都必须拧在正确的位置上。一旦搭建成功，它将成为你探索机器人智能的强大沙盒。