关于使用四元数检测特定轴（X轴）旋转进度的技术咨询

嘿，我完全懂你的痛点——欧拉角的万向锁和多表示问题真的很闹心，明明物体没绕X轴转，欧拉角的X值却乱跳。用四元数解决这个问题确实是正确方向，下面我一步步给你讲清楚怎么做：

为什么欧拉角会出问题？ #

欧拉角是按固定顺序（比如Unity里是Z→X→Y）表示旋转的，当物体绕Y轴转90度时，X轴和Z轴会重合，触发万向锁——此时绕X轴和Z轴的旋转会耦合，导致欧拉角的X值出现异常跳变。而且同一旋转能用多组欧拉角表示（比如359度和-1度是同一个旋转），这也会让你的旋转进度检测出错。

四元数的解决方案思路 #

我们的核心需求是：只关心物体绕自身X轴的旋转，完全忽略Y/Z轴的旋转影响。四元数可以准确表示任意旋转，我们可以通过计算当前姿态与初始姿态的相对旋转，再从中提取出纯绕X轴的旋转分量。

步骤1：保存初始姿态的四元数 #

首先，记录下物体初始状态（X轴旋转15度时）的四元数。如果初始时物体已经有Y/Z轴旋转，直接保存它的当前旋转即可：

// Unity示例代码，其他引擎/框架的四元数API逻辑类似
Quaternion initialRotation = transform.rotation;
// 如果初始状态是手动设置X=15度、Y/Z=0，也可以这样创建：
// Quaternion initialRotation = Quaternion.Euler(15f, 0f, 0f);

步骤2：计算相对旋转四元数 #

相对旋转表示从初始姿态到当前姿态的旋转变化，它会消除初始姿态的影响，只保留后续的旋转增量：

Quaternion relativeRotation = Quaternion.Inverse(initialRotation) * transform.rotation;

步骤3：提取纯绕X轴的旋转角度 #

现在我们要从relativeRotation中过滤掉Y/Z轴的旋转，只保留绕X轴的部分。这里有个实用技巧：利用“绕X轴旋转时，物体的局部Y轴会在垂直于X轴的平面内转动”的特性，通过向量角度计算得到旋转角度：

// 初始局部Y轴（在相对旋转的局部空间中，对应世界空间的Vector3.up）
Vector3 initialLocalY = Vector3.up;
// 应用相对旋转后的局部Y轴
Vector3 rotatedLocalY = relativeRotation * initialLocalY;

// 将两个向量投影到垂直于X轴的平面（YZ平面），过滤掉X轴方向的分量
Vector3 initialYProj = Vector3.ProjectOnPlane(initialLocalY, Vector3.right);
Vector3 rotatedYProj = Vector3.ProjectOnPlane(rotatedLocalY, Vector3.right);

// 避免除以零的情况（比如触发万向锁时）
if (initialYProj.sqrMagnitude < 0.0001f || rotatedYProj.sqrMagnitude < 0.0001f)
{
    // 此时无法准确计算，可返回上次记录的角度或0
    return;
}

// 归一化向量，确保角度计算准确
initialYProj.Normalize();
rotatedYProj.Normalize();

// 计算带方向的旋转角度（正负表示顺时针/逆时针）
float dot = Vector3.Dot(initialYProj, rotatedYProj);
float cross = Vector3.Cross(initialYProj, rotatedYProj).x; // 取X轴分量判断旋转方向
float rotationDeltaX = Mathf.Atan2(cross, dot) * Mathf.Rad2Deg;

// 初始X轴旋转是15度，所以当前总旋转角度为
float currentXRotation = 15f + rotationDeltaX;

为什么这个方法有效？ #

• 我们在相对旋转的局部空间中计算，完全隔离了Y/Z轴旋转的影响——不管物体在世界空间中怎么绕Y/Z轴转，相对旋转已经消除了这些变化。
• 通过投影到YZ平面，我们只关注绕X轴旋转带来的Y轴方向变化，过滤掉了其他旋转的干扰。
• 用Atan2计算角度，避免了欧拉角的多表示问题（不会出现359度突然跳到0度的情况）。

额外提示 #

如果你需要累计旋转进度（比如物体绕X轴转了好几圈，要记录总旋转角度，而非0-360度循环），可以在每次计算出rotationDeltaX后，把它累加到一个变量中：

private float totalXRotation = 15f; // 初始值

// 每一帧更新时
totalXRotation += rotationDeltaX;
// 这样totalXRotation会累计所有绕X轴的旋转，比如转了两圈就是15+720=735度

内容的提问来源于stack exchange，提问作者Dani Roca