Unity中CharacterController玩家无限跳跃问题求助

核心问题分析 #

导致isCharacterGrounded始终为true的原因有两个：

• Physics.CheckSphere未指定地面层掩码：HandleIsGrounded方法中调用Physics.CheckSphere时，仅传入了位置和检测半径，未传入定义好的groundMask参数，导致检测范围包含所有层（比如角色自身碰撞体），无论是否在空中都会返回true。
• isCharacterGrounded的序列化属性干扰：你给该变量添加了[SerializeField]，若在Inspector面板手动勾选过，面板设置会覆盖代码逻辑的赋值，导致变量始终处于勾选状态。

另外，Unity的CharacterController组件自带isGrounded属性，专门用于检测角色接地状态，比自定义球体检测更精准可靠。

修复方案 #

方案一：修复自定义检测逻辑 #

修改HandleIsGrounded方法并移除序列化属性，避免面板值干扰：

// 移除[SerializeField]，防止面板设置覆盖逻辑赋值
private bool isCharacterGrounded = false;

private void HandleIsGrounded()
{
    // 添加groundMask参数，仅检测指定地面层
    isCharacterGrounded = Physics.CheckSphere(transform.position, groundDistance, groundMask);
}

方案二：改用CharacterController自带的isGrounded（推荐） #

直接使用组件原生的接地检测，省去自定义逻辑的误差：

// 移除自定义的isCharacterGrounded字段和HandleIsGrounded方法

private void Update()
{
    // 调整执行顺序：先处理重力更新接地状态，再处理跳跃
    HandleGravity();
    HandleJumping();
    HandleRunning();
    HandleMovement();
}

private void HandleGravity()
{
    // 改用controller.isGrounded判断接地状态
    if (controller.isGrounded && velocity.y < 0)
    {
        velocity.y = -2f;
    }

    velocity.y += gravity * Time.deltaTime;
    controller.Move(velocity * Time.deltaTime);
}

private void HandleJumping()
{
    // 改用controller.isGrounded限制跳跃
    if (Input.GetKeyDown(KeyCode.Space) && controller.isGrounded)
    {
        velocity.y += Mathf.Sqrt(jumpForce * -2 * gravity);
    }
}

额外优化提示 #

• 检查groundMask配置：确保Inspector面板中该变量仅勾选了地面所在的层，不要包含角色层或其他非地面层。
• 保持合理的执行顺序：先处理重力更新接地状态，再处理跳跃，避免状态判断延迟。

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