Unity玩家跳跃逻辑异常：isGrounded始终为True（离地时仍生效）

问题核心原因 #

1. CharacterController不触发OnCollisionEnter：你代码里写的OnCollisionEnter完全无效——CharacterController通过Move方法移动时，不会触发常规的碰撞回调（比如OnCollisionEnter、OnCollisionStay），落地后canJump没法通过这个方法重置。
2. 地面检测误判自身：Physics.CheckSphere默认会检测指定层的所有碰撞体，包括玩家自己的碰撞体。如果groundMask不小心包含了玩家所在层，或者检测球体半径太大碰到自身，就会导致isGrounded一直返回true。
3. groundCheck位置/半径不合理：如果groundCheck没放在玩家模型底部（比如在胶囊体中心），或者groundDistance太大，空中时检测球也能碰到地面，直接导致误判。

修复后的完整代码 #

using UnityEngine;

public class PlayerController : MonoBehaviour
{
    public float speed = 10f;         // 移动速度
    public float jumpForce = 10f;     // 跳跃力度
    private bool canJump = true;      // 跳跃允许标记

    private CharacterController controller;
    private Vector3 velocity;        // 用于应用重力和跳跃力

    public Transform groundCheck;     // 地面检测位置
    public float groundDistance = 0.3f;  // 地面检测球体半径（可调整）
    public LayerMask groundMask;      // 地面层掩码

    void Start()
    {
        controller = GetComponent<CharacterController>();
        // 避免空引用报错
        if (groundCheck == null)
        {
            Debug.LogError("记得给groundCheck拖一个Transform组件！");
        }
    }

    void Update()
    {
        // 地面检测：忽略触发器，同时确保只检测地面层（排除自身）
        bool isGrounded = Physics.CheckSphere(groundCheck.position, groundDistance, groundMask, QueryTriggerInteraction.Ignore);

        // 调试输出，方便看检测状态
        Debug.Log("是否落地: " + isGrounded + " | 检测点位置: " + groundCheck.position);

        // 落地逻辑：重置垂直速度，允许跳跃
        if (isGrounded)
        {
            if (velocity.y < 0)
            {
                velocity.y = -2f;  // 轻微向下力，让玩家贴紧地面
            }
            canJump = true;
        }
        else
        {
            canJump = false;
        }

        // 玩家移动：标准化向量，避免斜向移动过快
        float moveX = Input.GetAxis("Horizontal");
        float moveZ = Input.GetAxis("Vertical");
        Vector3 move = transform.right * moveX + transform.forward * moveZ;
        controller.Move(move.normalized * speed * Time.deltaTime);

        // 跳跃逻辑
        if (Input.GetButtonDown("Jump") && canJump)
        {
            velocity.y = Mathf.Sqrt(jumpForce * -2f * Physics.gravity.y);
            canJump = false;
        }

        // 应用重力
        velocity.y += Physics.gravity.y * Time.deltaTime;
        controller.Move(velocity * Time.deltaTime);
    }

    // 可视化检测区域：落地绿色，空中红色
    void OnDrawGizmos()
    {
        if (groundCheck != null)
        {
            bool tempGrounded = Physics.CheckSphere(groundCheck.position, groundDistance, groundMask, QueryTriggerInteraction.Ignore);
            Gizmos.color = tempGrounded ? Color.green : Color.red;
            Gizmos.DrawWireSphere(groundCheck.position, groundDistance);
        }
    }
}

关键修复说明 #

• 移除无效的OnCollisionEnter：CharacterController不识别这个回调，直接删除即可。
• 优化地面检测逻辑：添加QueryTriggerInteraction.Ignore忽略触发器，同时在Unity编辑器里检查groundMask只勾选地面层，不要包含玩家自身的层。
• 标准化移动向量：原代码斜向移动速度会比直线移动快，修复后各方向移动速度保持一致。
• 动态Gizmos显示：根据检测状态改变球体颜色，在Scene视图里能直观判断当前是否落地，调试更方便。

额外调试步骤 #

1. 把groundCheck拖到玩家模型的底部位置（比如胶囊体最低点下方0.1f处），确保检测球在玩家脚下。
2. 调整groundDistance：如果还是出现误判，把数值改小一点（比如0.2f），避免空中碰到地面。
3. 检查groundMask配置：在Inspector里打开groundMask下拉框，只勾选标记为Ground的层，玩家自身的层必须取消勾选。

内容的提问来源于stack exchange，提问作者Mohamed aziz Dhbebniya