# Unitree SDK H2踝关节顺序与MuJoCo仿真不一致

> 原文链接：https://robotics.hellobike.com/pitfalls/2026-06-08-unitree-mujoco-123
> 频道：pitfalls | 更新日期：2026-06-08 | 标签：auto, github-issue, unitree_mujoco
> 核心摘要：H2机器人SDK中踝关节pitch/roll顺序错误导致与仿真不符，官方已修复SDK使其与文档及MuJoCo模型对齐。

# Unitree SDK H2踝关节顺序与MuJoCo仿真不一致

::: v-pre
> 本文由 AI 根据公开内容整理，可能有误，请以原文为准：[H2 ankle joint order doesn't match Unitree SDK](https://github.com/unitreerobotics/unitree_mujoco/issues/123)（GitHub unitreerobotics/unitree_mujoco #123）

**状态**：已解决

## 问题

在unitree_mujoco仿真器中，H2左右踝关节的jointvel、jointpos及jointactuatorfrc数据顺序为ankle roll后接ankle pitch；而Unitree SDK示例代码及旧版实现中顺序相反（先pitch后roll），导致仿真与真机控制接口数据映射错位。

## 环境

机型：Unitree H2；软件：unitree_mujoco (h2_mujoco.xml)、unitree_sdk2 (h2_ankle_swing_example.cpp)

## 解决办法

1. 确认H2踝关节正确顺序应为先ankle roll后ankle pitch，以MuJoCo模型定义和官方文档为准。
2. 更新unitree_sdk2至最新版本，该版本已修正此前SDK中踝关节顺序反转的错误实现。
3. 在算法开发与控制部署时，统一使用roll-pitch顺序进行状态读取与指令下发，避免依赖旧版SDK逻辑。

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

## 原始参考来源 (Sources)

- [GitHub unitreerobotics/unitree_mujoco #123：H2 ankle joint order doesn't match Unitree SDK](https://github.com/unitreerobotics/unitree_mujoco/issues/123)