开发悬浮板控制器时绕X轴旋转超90度出现Y/Z轴翻转问题求助

你遇到的是欧拉角万向锁问题——当绕X轴旋转接近90度时，欧拉角的三个旋转轴会出现重合，导致Y、Z轴的旋转逻辑混乱，出现异常翻转。直接读取transform.eulerAngles计算目标旋转会放大这个问题，因为Unity内部会将旋转转换为0-360范围内的欧拉角，容易出现数值跳变。

以下是两种有效的解决方案：

方案1：维护独立旋转变量，绕开Unity欧拉角转换 #

自己管理X、Y轴的旋转值，直接用这些值构建四元数，避免依赖transform.eulerAngles的不稳定数值：

// 在类中声明全局变量
private float xRot = 0f;
private float yRot = 0f;
public float maxXRot = 90f; // 限制X轴最大俯仰角度

void Update()
{
    float h_input = Input.GetAxis(HorizontalControlsAxis);
    float v_input = Input.GetAxis(VerticalControlsAxis);

    // 处理水平转向（Y轴）
    yRot += h_input * rotSpeed * Time.deltaTime;

    // 处理俯仰旋转（X轴），并限制角度范围
    xRot += v_input * vRotSpeed * Time.deltaTime;
    xRot = Mathf.Clamp(xRot, -maxXRot, maxXRot);

    // 保持原有的Z轴倾斜逻辑
    leanAmount = Mathf.Clamp(leanAmount + -h_input * leanSpeed * Time.deltaTime, -maxLean, maxLean);
    leanAmount = Mathf.Lerp(leanAmount, 0, Mathf.Abs(leanAmount) / maxLean);

    // 构建目标旋转四元数并应用
    Quaternion targetRotation = Quaternion.Euler(xRot, yRot, leanAmount);
    transform.rotation = targetRotation;
}

方案2：单轴增量旋转，规避万向锁 #

使用transform.Rotate分步做单轴旋转，每次只修改一个轴的旋转，从根源上避免欧拉角的轴重合问题：

void Update()
{
    float h_input = Input.GetAxis(HorizontalControlsAxis);
    float v_input = Input.GetAxis(VerticalControlsAxis);

    // 水平旋转：绕世界Y轴（若需自身空间旋转，将Space.World改为Space.Self）
    transform.Rotate(Vector3.up, h_input * rotSpeed * Time.deltaTime, Space.World);

    // 处理俯仰旋转（X轴）：先转换角度范围，再限制最大值
    float currentX = transform.localEulerAngles.x;
    currentX = currentX > 180 ? currentX - 360 : currentX;
    currentX += v_input * vRotSpeed * Time.deltaTime;
    currentX = Mathf.Clamp(currentX, -maxXRot, maxXRot);
    currentX = currentX < 0 ? currentX + 360 : currentX;

    // 应用X轴俯仰和Z轴倾斜
    transform.localEulerAngles = new Vector3(currentX, transform.localEulerAngles.y, leanAmount);

    // 保持原有的Z轴倾斜逻辑
    leanAmount = Mathf.Clamp(leanAmount + -h_input * leanSpeed * Time.deltaTime, -maxLean, maxLean);
    leanAmount = Mathf.Lerp(leanAmount, 0, Mathf.Abs(leanAmount) / maxLean);
}

两种方案的核心都是避免直接基于transform.eulerAngles做累加计算，要么自己维护旋转状态，要么分步做单轴增量旋转，这样就能绕开欧拉角的万向锁限制，同时防止Unity欧拉角转换带来的数值跳变。

内容的提问来源于stack exchange，提问作者Attilio Campardou