Unity FPS控制器贴墙时无法正常跳跃问题求助

嘿，我之前跟着那个同款FPS控制器教程做的时候也碰到过一模一样的贴墙跳坑！问题出在接地检测的稳定性和CharacterController的碰撞逻辑上，下面给你一步步拆解和修复方案：

问题到底出在哪？ #

你的跳跃逻辑靠Physics.CheckSphere判断是否接地，但当玩家紧贴墙壁时，这个检测球（半径0.4f）很可能会同时碰到墙壁和地面，或者因为CharacterController被墙壁挤压，导致groundCheck的位置被稍微顶离地面——结果就是你按跳的那帧，isGrounded突然变成false，跳跃逻辑直接跳过了。

另外，你把接地时的velocity.y设为-2f，这个向下的小速度在贴墙时会让角色和地面的接触状态变得不稳定，进一步干扰检测。

具体修复步骤 #

1. 换掉自定义接地检测，用CharacterController自带的 #

Unity的CharacterController.isGrounded是专门为角色移动优化的，它只会检测角色底部的碰撞，比你自己写的Sphere检测靠谱多了。直接替换掉原来的isGrounded赋值：

// 删掉原来的Physics.CheckSphere那行，改成这个
isGrounded = CharacterController.isGrounded;

这样你甚至可以去掉groundCheck和groundDistance这两个变量，省得维护。

2. 优化velocity的处理逻辑 #

把接地时的velocity.y从-2f改成0f，让角色稳定站在地面上，不要一直有向下的力：

if (isGrounded && velocity.y < 0)
    velocity.y = 0f; // 原来的-2f会让角色持续压向地面，贴墙时容易出问题

另外，在跳跃时可以加个微小的向上位移，确保角色瞬间离开地面，避免贴墙时刚跳起来就又被判定为接地：

if (Input.GetButtonDown("Jump") && isGrounded)
{
    velocity.y = Mathf.Sqrt(playerJumpSpeed * -2f * playerGravity);
    // 加个0.01f的向上移动，强制离开地面检测范围
    CharacterController.Move(Vector3.up * 0.01f);
}

3. 检查你的groundMask图层 #

确保groundMask只勾选了地面的图层，别把墙壁也包含进去。如果地面和墙壁用了同一个图层，之前的Sphere检测会把墙壁当成地面，但用了CharacterController自带的检测后这个问题就自动消失了。

修复后的完整Movement Script #

[SerializeField] CharacterController CharacterController = default;
// 如果你用CharacterController.isGrounded，groundMask和groundCheck都可以删掉了
// [SerializeField] LayerMask groundMask = default;
// [SerializeField] Transform groundCheck = default;

bool isGrounded = false;

public float playerSpeed;
public float playerGravity;
public float playerJumpSpeed;

Vector3 velocity;

private void Update()
{
    // 用CharacterController自带的接地检测，精准又省心
    isGrounded = CharacterController.isGrounded;

    if (isGrounded && velocity.y < 0)
        velocity.y = 0f;

    float x = Input.GetAxis("Horizontal");
    float z = Input.GetAxis("Vertical");

    Vector3 move = transform.right * x + transform.forward * z;
    // 把移动方向固定在水平面上，避免贴墙时的垂直干扰
    move.y = 0;
    // 斜向移动时归一化，防止速度翻倍
    if (move.magnitude > 1f) move.Normalize();
    CharacterController.Move(move * playerSpeed * Time.deltaTime);

    if (Input.GetButtonDown("Jump") && isGrounded)
    {
        velocity.y = Mathf.Sqrt(playerJumpSpeed * -2f * playerGravity);
        // 强制微小位移，确保离开地面检测
        CharacterController.Move(Vector3.up * 0.01f);
    }

    velocity.y += playerGravity * Time.deltaTime;
    CharacterController.Move(velocity * Time.deltaTime);
}

额外调试小技巧 #

• 如果还是有问题，在Update里加一行Debug.Log(isGrounded);，看看你按跳的那帧isGrounded到底是true还是false，就能精准定位问题了。
• 可以在Scene视图里给CharacterController开Gizmos，看看它的碰撞范围是不是和你的角色模型匹配。

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