Unity设置localEulerAngles出现异常结果的原因及解决方法

我编写了如下代码：

if (Input.GetKeyDown(KeyCode.A))
{
    var rot = switchTransform.localEulerAngles;
    Debug.Log(rot);
    rot.x = 150;
    switchTransform.localEulerAngles = rot;
}

按下A键时，Inspector面板中switchTransform的角度从(30, 0, 0)变为(150, 0, 0)，但控制台输出却从(30, 0, 0)变为(30, 180, 180)。

使用以下写法则能正常运行：

angle = 150f;
if (Mathf.Abs(angle) <= 180 && Mathf.Abs(angle) > float.Epsilon)
{
    angle = 180 - angle;
}
if (Input.GetKeyDown(KeyCode.A))
{
    var rot = switchTransform.localEulerAngles;
    rot.x = angle;
    switchTransform.localEulerAngles = rot;
}

请问该异常产生的原因是什么？是否有更优的解决办法？
注：该switchTransform的轴心点不在物体几何中心，而是偏移至一侧。

这是Unity欧拉角的万向锁（Gimbal Lock）和角度表示歧义共同导致的：

• Unity内部用四元数存储旋转数据，欧拉角只是为了方便开发者操作的直观显示形式。当你设置localEulerAngles.x = 150时，Unity会将该欧拉角转换为四元数，但由于物体轴心偏移，这个旋转对应的四元数存在另一种等价的欧拉角表示——(30, 180, 180)。这两组欧拉角对应的实际旋转效果完全一致，所以Inspector会优先显示符合开发者直觉的150度，但读取localEulerAngles时，返回的是Unity内部计算出的等价角度值。
• 你手动转换angle = 180 - angle后，实际上是绕X轴旋转了30度（180-150=30），结合轴心偏移的情况，这个旋转对应的四元数没有欧拉角表示歧义，因此读取和显示的结果一致。

推荐优先使用四元数或Unity提供的旋转方法，避免直接修改欧拉角带来的歧义：

方法1：直接设置四元数旋转 #

如果要将物体局部X轴旋转到150度，直接用四元数赋值，绕开元欧拉角的歧义问题：

if (Input.GetKeyDown(KeyCode.A))
{
    switchTransform.localRotation = Quaternion.Euler(150, 0, 0);
}

如果是相对当前角度旋转到目标值，也可以计算差值后旋转：

if (Input.GetKeyDown(KeyCode.A))
{
    float targetAngle = 150f;
    float currentAngle = switchTransform.localEulerAngles.x;
    float rotateDelta = targetAngle - currentAngle;
    switchTransform.Rotate(Vector3.right, rotateDelta);
}

方法2：统一欧拉角的范围处理 #

如果必须使用欧拉角，建议在读取和设置时统一将角度归一化到[-180, 180]或[0, 360]的固定范围，避免歧义：

// 工具方法：将角度归一化到[-180, 180]区间
float NormalizeAngle(float angle)
{
    angle %= 360f;
    if (angle > 180f)
        angle -= 360f;
    else if (angle < -180f)
        angle += 360f;
    return angle;
}

// 使用示例
if (Input.GetKeyDown(KeyCode.A))
{
    var rot = switchTransform.localEulerAngles;
    rot.x = NormalizeAngle(150f);
    switchTransform.localEulerAngles = rot;
    
    // 读取时也做归一化，保证输出一致
    var normalizedRot = new Vector3(
        NormalizeAngle(rot.x),
        NormalizeAngle(rot.y),
        NormalizeAngle(rot.z)
    );
    Debug.Log(normalizedRot);
}

方法3：使用Transform的旋转API替代直接修改欧拉角 #

Unity提供了Rotate、RotateAround等更安全的旋转方法，这些方法内部直接操作四元数，不会出现欧拉角的表示歧义问题，适合需要基于轴心偏移的旋转场景。

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