前置条件 / 环境说明

在开始使用 MuJoCo 仿真器之前，请先确认你的环境满足以下条件：

• 操作系统：Windows、macOS 或 Linux 均可，MuJoCo 官方提供跨平台支持。
• 安装方式：任选其一即可。
  • 预编译二进制：从 MuJoCo 官方 GitHub Releases 页面下载对应平台的压缩包，解压后即可使用。
  • 源码编译：克隆官方仓库后，按照 README 指引使用 CMake 编译生成 simulate 可执行文件。
  • Python 绑定：执行 pip install mujoco 安装官方 Python 包。

安装可参考MuJoCo 安装教程：Ubuntu 环境下的完整配置与避坑指南-CSDN博客

• 模型文件：官方仓库的 model 目录下自带 humanoid.xml、ant.xml 等示例模型，可直接用于测试。

确认以上条件就绪后，即可按照下文步骤启动仿真器。

一、 启动仿真器

根据你的安装方式，可以通过以下两种途径启动仿真器：

1. 原生 C++ 版本（simulate）

如果你使用的是预编译二进制文件或自行编译的源码，仿真器可执行程序位于 bin 目录下。

• 直接运行：在终端中进入 bin 目录，运行 ./simulate。
• 加载模型：可以在启动时直接传入模型路径，例如 ./simulate ../model/humanoid.xml。

2. Python 版本（mujoco.viewer）

对于通过 pip install mujoco 安装 Python 绑定的用户，可以直接在终端运行以下命令启动可视化查看器：

python -m mujoco.viewer

该命令会打开一个默认场景的仿真窗口，方便快速验证安装是否成功。

---

二、 鼠标与键盘交互操作

在仿真器窗口中，你可以通过鼠标与物理世界进行实时交互：

视角控制

• 左键拖动：旋转视角。
• 右键拖动：平移视角。
• 滚轮滑动：缩放视角。

物体交互

• 双击物体：选中并高亮该物体。
• Ctrl + 左键：在选中物体的状态下拖动，可调整物体的姿态（位置与旋转）。
• Ctrl + 右键：在选中的位置施加一个外部扰动力。

仿真控制

• + / - 键：调节仿真世界的时间流逝速度（加快或减慢）。
• Ctrl + A：将相机视角回正到初始状态。
• Delete 键：重置当前仿真世界。

---

三、 核心快捷键速查表

MuJoCo 提供了极其丰富的快捷键，用于在调试过程中可视化不同的物理属性。以下是常用快捷键的分类速查：

1. 基础系统与视图控制

快捷键	功能描述
F1	呼出帮助菜单（Help）
F2	显示系统资源信息（Info），如 CPU、内存、帧率
F3	打开性能分析器（Profiler）
F4	查看传感器数据（Sensors）
F5	切换全屏模式
TAB	隐藏/显示左侧工具栏
[ / ]	切换不同的相机视角

2. 物理与几何可视化

快捷键	功能描述
F6	切换可视化坐标系（Frame）
F7	显示/隐藏实体名字标签（Label）
`	显示 Geom 最小外接矩形及碰撞状态
W	世界网格化显示
T	几何体透明化
H	凸包（Convex Hull）可视化
D	仅显示 Body 骨架
\	显示 Mesh Tree（网格树）
;	Skin（皮肤）可视化

3. 动力学与传感器调试

快捷键	功能描述
P	接触点（Contact）可视化
F	接触力大小及方向可视化
B	扰动力大小及方向可视化
J	关节方向及旋转方向可视化
U	驱动器（Actuator）方向可视化
I	转动惯量可视化
'	缩放转动惯量显示比例
M	质心（Center of Mass）可视化
,	激活状态（Activation）可视化
V	肌腱（Tendon）可视化
E	等价约束（Equality）可视化

4. 渲染与光照控制

快捷键	功能描述
Q	Camera（相机）可视化
R	开关光线反射效果
S	调整画面亮度
G	开启/关闭迷雾效果
/	开启/关闭地平线雾气（Haze）
K	关闭天空盒（Skybox）
X	关闭纹理贴图（Texture）
Z	灯光控制
Y	测距可视化
O	调整物体位姿的辅助可视化
A	Auto Connect（自动连接）

---

四、 学习建议

1. 先玩模型，再看代码：建议先加载官方提供的 humanoid.xml 或 ant.xml 模型，使用上述快捷键（特别是 F、P、J）观察受力、接触点和关节状态。
2. 肌肉记忆：将 空格键（暂停/继续）、Delete（RESET）Ctrl+A（视角回正）和鼠标交互作为日常操作习惯。
3. 按需查阅：可视化快捷键非常多，无需死记硬背。遇到需要调试特定物理属性（如质心、转动惯量）时，随时查阅本指南即可。

---

五、 总结与避坑提示

本文介绍了 MuJoCo 仿真器的两种启动方式、鼠标键盘交互操作以及核心快捷键速查表。掌握这些基础操作后，你就能在调试模型时快速观察物理反馈，提升开发效率。

以下是几个常见的避坑提示，供你参考：

• 启动失败时先检查路径：运行 ./simulate 前，请确认当前目录确实位于 bin 目录下，且可执行文件具有运行权限。
• Python 版本注意依赖：执行 python -m mujoco.viewer 前，请确认 mujoco 已正确安装，且 Python 环境与 pip 安装环境一致。
• 快捷键冲突：部分快捷键（如 Ctrl+A）可能与操作系统或输入法冲突，若无效请检查系统快捷键设置。
• 模型加载失败：如果模型文件路径包含中文或空格，建议先复制到纯英文路径下再加载，避免解析异常。