# MuJoCo开启USD编译失败及测试Schema缺失报错

> 原文链接：https://robotics.hellobike.com/pitfalls/2026-11-09-mujoco-3695
> 频道：pitfalls | 更新日期：2026-11-09 | 标签：auto, github-issue, mujoco
> 核心摘要：修复MuJoCo启用USD时usd_decoder_test头文件路径错误及mjcPhysics schema未拷贝至构建目录导致测试失败的问题。

# MuJoCo开启USD编译失败及测试Schema缺失报错

::: v-pre
> 本文由 AI 根据公开内容整理，可能有误，请以原文为准：[MUJOCO_WITH_USD=ON: usd_decoder_test fails to compile, and USD tests fail from the build tree](https://github.com/google-deepmind/mujoco/issues/3695)（GitHub google-deepmind/mujoco #3695）

**状态**：已解决

## 问题

在Ubuntu 22.04下使用-DMUJOCO_WITH_USD=ON编译MuJoCo main分支时，usd_decoder_test因引用内部third_party/usd/v26路径报错fatal error: fileSystem.h: No such file or directory；

## 环境

Ubuntu 22.04 x86_64, GCC 11.4, CMake 4.4, OpenUSD 25.11, MuJoCo main分支(commit 70dede937)

## 解决办法

1. 更新MuJoCo源码至commit 70dede937或更高版本，该版本已通过338bf4aab修复test/plugin/usd_decoder/usd_decoder_test.cc中的&lt;pxr/...&gt;头文件引用路径。
2. 确保包含2cba71c6d提交，该修改将mjcPhysics/generatedSchema.usda在configure阶段自动stage到build/lib/mujoco-usd-resources/目录，解决非安装环境下schema加载失败问题。
3. 若使用OpenUSD v25.11 wheel，需在配置MuJoCo时添加-DCMAKE_CXX_FLAGS=-D_GLIBCXX_USE_CXX11_ABI=0以匹配manylinux2014 ABI；若使用OpenUSD 26.3+或源码编译（默认C++11 ABI），则需移除该标志以避免符号不匹配。

讨论原作者：@andrewkaufman 等，版权归原作者所有。
:::

## 原始参考来源 (Sources)

- [GitHub google-deepmind/mujoco #3695：MUJOCO_WITH_USD=ON: usd_decoder_test fails to compile, and USD tests fail from the build tree](https://github.com/google-deepmind/mujoco/issues/3695)