安装mujoco_py时出现Cython编译错误求助

安全阿岳

2026-7-12

解决MuJoCo-Py编译时回调函数类型不兼容问题

问题根源

这个编译错误是因为新版GCC（GCC 7及以上版本）对C异常处理的检查更严格，而mujoco_py的cymj.pyx文件中定义的回调函数未符合现代C的noexcept要求，导致函数指针类型不匹配。

定位cymj.pyx文件
如果你是通过pip安装的mujoco_py，执行以下命令找到文件位置：
```
python3 -c "import mujoco_py; print(mujoco_py.__file__)"
```
进入输出的目录，找到核心源码文件夹里的cymj.pyx文件。
修改回调函数声明
打开cymj.pyx，找到报错提示的回调函数定义（通常是日志或消息回调相关的函数），将原来的：
```
void (const char *) except * nogil
```
替换为：
```
void (const char *) noexcept nogil
```
注意要把所有同类型的回调函数声明和实现都做相同修改。
重新编译mujoco_py
先清理旧编译缓存并卸载原有版本：
```
pip uninstall -y mujoco_py
rm -rf ~/.cache/mujoco_py
```
再重新安装（强制不使用缓存）：
```
pip install mujoco_py --no-cache-dir
```
如果你是从源码安装的，进入mujoco_py目录后执行：
```
python setup.py build_ext --inplace
pip install -e .
```
验证修复效果
重新运行你的脚本：
```
python3 setting_state.py
```