Ubuntu 20.04下Mujoco210环境搭建避坑指南：从依赖安装到Gym测试全流程

Ubuntu 20.04下Mujoco210环境搭建：从零到精通的实战避坑手册

如果你正在踏入强化学习或机器人仿真的领域，那么Mujoco这个名字对你来说一定不陌生。作为物理仿真引擎中的佼佼者，Mujoco以其高效、精准的计算能力，成为了众多前沿研究和工业应用的首选工具。然而，对于许多初学者甚至是有一定经验的开发者而言，在Ubuntu系统上成功搭建起一个稳定可用的Mujoco环境，却常常是一场充满挫折的“历险记”。依赖冲突、版本不匹配、诡异的OpenGL报错……这些拦路虎足以让热情消耗殆尽。

这篇文章正是为你准备的。我不会仅仅给你一份“一帆风顺”的安装清单，那在现实世界中几乎不存在。相反，我将以一个“过来人”的身份，带你走一遍我在Ubuntu 20.04上搭建Mujoco210、mujoco-py以及Gym环境的完整流程，并重点剖析那些我踩过的、以及你可能即将踩到的每一个“坑”。我们将从最基础的系统准备开始，深入到每一个关键步骤的风险评估和解决方案，最终让你能够自信地运行起第一个仿真环境。准备好了吗？让我们开始这场“排雷”之旅。

1. 环境准备：打好地基，规避系统性风险

在动手安装任何软件之前，确保你的系统基础是稳固的，这能避免至少一半后续的诡异问题。对于Ubuntu 20.04，我们首先要做的不是急着下载Mujoco，而是进行一次全面的系统检查和更新。

打开你的终端，执行以下命令来更新软件包列表并升级所有已安装的包。这个过程可能需要一些时间，取决于你的网络速度和系统更新量。

sudo apt update && sudo apt upgrade -y

注意：在执行系统升级时，如果遇到内核更新，建议完成后重启系统，以确保新内核生效。这能避免一些底层库的兼容性问题。

接下来，我们需要安装一系列基础编译工具和依赖库。这些库是后续编译mujoco-py等Python包所必需的。很多教程会一股脑地列出一长串命令，但这里我想根据其功能分组说明，让你明白每个包的作用。

核心编译与开发工具：

• build-essential: 包含GCC、G++、make等核心编译工具链。这是编译任何C/C++扩展的基石。
• python3-dev 和 python3-pip: 确保你拥有Python的开发头文件和最新的pip包管理器。Ubuntu 20.04默认的Python 3.8是兼容的，但开发包需要单独安装。

图形与渲染依赖： 这是Mujoco环境最容易出问题的部分，尤其是对于使用服务器或无头（headless）模式的情况。

• libgl1-mesa-dev: Mesa OpenGL库的开发文件。
• libgl1-mesa-glx: Mesa OpenGL兼容性运行时库。
• libosmesa6-dev: 离屏渲染（OSMesa）库的开发文件，对于无GPU或需要离屏渲染的环境至关重要。
• libglew-dev: OpenGL扩展加载库，许多OpenGL高级功能需要它。
• libglfw3 和 libglfw3-dev: 提供创建窗口、上下文和接收输入的跨平台库，是OpenGL程序的前端。

其他实用工具：

• patchelf: 一个修改ELF文件（可执行文件和共享库）的小工具，mujoco-py在安装过程中会用到它来修补库路径。
• unzip, curl, wget: 用于下载和解压文件的常用工具。

你可以用下面这条组合命令一次性安装它们：

sudo apt install build-essential python3-dev python3-pip \
                 libgl1-mesa-dev libgl1-mesa-glx libosmesa6-dev \
                 libglew-dev libglfw3 libglfw3-dev \
                 patchelf unzip curl wget -y

安装完成后，我强烈建议你验证一下几个关键库的版本，特别是GCC。因为后续mujoco-py编译时对GLIBCXX版本有要求。运行 gcc --version 查看你的GCC版本。在Ubuntu 20.04上，默认通常是9.x版本。如果版本过低（比如低于7），你可能需要提前考虑升级，我们会在遇到具体报错时再详细处理。

2. 安装Mujoco 210本体：获取引擎与许可

Mujoco是一个商业软件，但自被DeepMind收购后，其个人使用和学术研究已经免费。我们需要从官网下载引擎本体和一个许可证文件。

2.1 下载与解压

首先，在你的家目录下创建隐藏文件夹 .mujoco，所有相关文件都将放在这里，这是社区约定俗成的最佳实践。

mkdir -p ~/.mujoco
cd ~/.mujoco

接下来，直接从Mujoco官网下载210版本的Linux压缩包。你可以使用 wget 命令。

wget https://mujoco.org/download/mujoco210-linux-x86_64.tar.gz

下载完成后，解压文件。解压后会生成一个 mujoco210 目录。