Unity零重力宇航员角色如何实现绕自身Y轴局部旋转

核心问题清单 #

• 欧拉角累积逻辑天然触发万向锁：你通过累积X/Y/Z三个欧拉角变量再转四元数的实现方式，本身就存在万向锁缺陷，只要两个旋转轴重合就会出现旋转锁死、异常的问题。
• 旋转逻辑未基于自身局部坐标系：Quaternion.Euler(X,Y,Z)默认生成基于世界坐标系的旋转四元数，赋值给localRotation时也是基于父节点坐标系计算，没有匹配你要的「相对角色自身局部轴旋转」需求。
• 输入逻辑冲突：键盘旋转输入和鼠标旋转输入同时修改MouseLook中的Y静态变量，两个输入互相干扰，导致旋转逻辑完全混乱。
• 物理逻辑不兼容：你使用Rigidbody控制力驱动移动，但直接修改Transform的旋转属性，会跳过物理引擎计算，出现卡顿、碰撞异常等问题，和物理驱动的移动逻辑不匹配。
• 静态变量设计缺陷：MouseLook中的X/Y/Z/euler都是静态变量，全局共享，场景重载、多实例共存时都会出现不可预知的错误。

修复方案 #

步骤1：重构旋转逻辑，基于物理扭矩实现局部旋转 #

抛弃欧拉角累积的方式，改用Rigidbody的AddRelativeTorqueAPI实现相对自身轴的旋转，完全规避万向锁，同时和物理移动逻辑兼容。

步骤2：拆分鼠标和键盘的输入逻辑，避免变量冲突 #

将输入的旋转增量统一在Astronaut脚本中处理，去掉MouseLook中的静态变量设计。

步骤3：调整旋转角度限制逻辑 #

如果需要限制俯仰角度，可以通过读取transform.localEulerAngles的x轴值做钳制处理。

修改后的代码示例 #

Astronaut.cs #

using System.Collections;
using System.Collections.Generic;
using UnityEngine;
using UnityEngine.InputSystem;

public class Astronaut : MonoBehaviour
{
    private AstronautControls astronautControls;
    public Rigidbody rb;
    public float force;
    public float torque;
    public float mouseSensitivity;
    // 角度限制
    public float minPitch = -90f;
    public float maxPitch = 90f;
    
    private Vector2 moveInput;
    private float moveUpDownInput;
    private Vector2 rotateInput;
    private Vector2 mouseDeltaInput;
    public PlayerInput playerInput;

    private void Awake()
    {
        astronautControls = new AstronautControls();
        rb = GetComponent<Rigidbody>();
        // 关闭Rigidbody的自动旋转冻结，让扭矩生效
        rb.freezeRotation = false;
    }


    private void OnEnable()
    {
        astronautControls.Enable();
    }

    private void OnDisable()
    {
        astronautControls.Disable();
    }

    void Update()
    {
        // 收集所有输入在Update里做，保证输入不丢失
        moveInput = playerInput.actions["Move"].ReadValue<Vector2>();
        moveUpDownInput = playerInput.actions["MoveVertical"].ReadValue<float>();
        rotateInput = new Vector2(
            playerInput.actions["RotateHorizontal"].ReadValue<float>(),
            playerInput.actions["RotateVertical"].ReadValue<float>()
        );
        mouseDeltaInput = Mouse.current.delta.ReadValue() * mouseSensitivity * Time.deltaTime;
    }

    void FixedUpdate()
    {
        Move();
        Rotate();
        ClampPitch();
    }

    private void Move()
    {
        rb.AddRelativeForce(Vector3.forward * force * moveInput.y * Time.fixedDeltaTime);
        rb.AddRelativeForce(Vector3.right * force * moveInput.x * Time.fixedDeltaTime);
        rb.AddRelativeForce(Vector3.up * force * moveUpDownInput * Time.fixedDeltaTime);
    }

    private void Rotate()
    {
        // 合并键盘和鼠标的旋转输入
        float yaw = rotateInput.x + mouseDeltaInput.x;
        float pitch = rotateInput.y - mouseDeltaInput.y;
        // 绕自身Y轴（偏航）和自身X轴（俯仰）施加扭矩
        rb.AddRelativeTorque(Vector3.up * yaw * torque * Time.fixedDeltaTime);
        rb.AddRelativeTorque(Vector3.right * pitch * torque * Time.fixedDeltaTime);
    }

    private void ClampPitch()
    {
        // 钳制俯仰角度，避免翻转过度
        float pitch = transform.localEulerAngles.x;
        pitch = pitch > 180 ? pitch - 360 : pitch;
        pitch = Mathf.Clamp(pitch, minPitch, maxPitch);
        transform.localEulerAngles = new Vector3(pitch, transform.localEulerAngles.y, transform.localEulerAngles.z);
    }
}

原MouseLook.cs可以直接删除，所有相关逻辑已经整合到Astronaut脚本中。 #

额外配置调整 #

• 打开Rigidbody组件关闭Use Gravity开关，匹配零重力需求。
• 调整torque和mouseSensitivity参数，到合适的旋转手感。
• 如果需要旋转更顺滑，可以给Rigidbody设置适当的Angular Drag（角阻力），避免旋转停不下来。

内容的提问来源于stack exchange，提问作者Art Zolina III