Unity玩家控制器IsGrounded函数无法检测地面问题求助

核心代码错误 #

你写的Ray数组初始化逻辑完全没给数组元素赋值！看这段代码：

Ray[] rays = new Ray[4];
{
    new Ray(transform.position + (transform.forward * 0.2f) + (Vector3.up * 0.1f), Vector3.down);
    new Ray(transform.position + (-transform.forward * 0.2f) + (Vector3.up * 0.1f), Vector3.down);
    new Ray(transform.position + (transform.right * 0.2f) + (Vector3.up * 0.1f), Vector3.down);
    new Ray(transform.position + (-transform.right * 0.2f) + (Vector3.up * 0.1f), Vector3.down);
};

这里的大括号只是一个空代码块，里面创建的Ray对象根本没存进rays数组，数组里全是默认的无效Ray（位置(0,0,0)、方向(0,0,0)），自然检测不到地面。

修正后的IsGrounded函数 #

把Ray对象正确赋值给数组元素，同时加上调试射线方便在Scene视图观察：

bool IsGrounded()
{
    Ray[] rays = new Ray[4];
    // 给数组每个索引赋值对应的射线
    rays[0] = new Ray(transform.position + transform.forward * 0.2f + Vector3.up * 0.1f, Vector3.down);
    rays[1] = new Ray(transform.position - transform.forward * 0.2f + Vector3.up * 0.1f, Vector3.down);
    rays[2] = new Ray(transform.position + transform.right * 0.2f + Vector3.up * 0.1f, Vector3.down);
    rays[3] = new Ray(transform.position - transform.right * 0.2f + Vector3.up * 0.1f, Vector3.down);

    for (int i = 0; i < rays.Length; i++)
    {
        // 在Scene视图画出射线，红色，方便调试
        Debug.DrawRay(rays[i].origin, rays[i].direction * 0.2f, Color.red);
        if (Physics.Raycast(rays[i], 0.2f, groundLayerMask))
        {
            Debug.Log("Grounded");
            return true;
        }
    }
    Debug.Log("Not Grounded");
    return false;
}

额外排查点 #

• LayerMask设置验证：确保groundLayerMask是正确的地面层掩码。如果地面是第8层，代码里要写groundLayerMask = 1 << 8;，不是直接写8；如果是Inspector赋值，确认拖选的Layer是地面层。
• 射线长度适配：当前射线向下长度是0.2f，起点在transform.position上方0.1f，总检测距离是0.3f。如果玩家胶囊体底部到地面的距离超过这个值，射线会漏检，可以适当调长到0.3f或0.4f。
• 触发碰撞体兼容：如果地面碰撞体开了Is Trigger，需要给Raycast加参数：Physics.Raycast(rays[i], 0.2f, groundLayerMask, QueryTriggerInteraction.Collide)，否则默认不检测触发碰撞体。

更优实现方案 #

方案1：Physics.CheckSphere（推荐） #

用球形检测替代多条射线，覆盖玩家脚边区域，稳定性更高，适配不规则地面：

[SerializeField] private float groundCheckRadius = 0.2f;
[SerializeField] private LayerMask groundLayerMask;
[SerializeField] private Transform groundCheckPoint; // 把这个空物体放在玩家胶囊体底部附近

bool IsGrounded()
{
    // 在Scene视图画出检测球，蓝色
    Debug.DrawSphere(groundCheckPoint.position, groundCheckRadius, Color.blue);
    return Physics.CheckSphere(groundCheckPoint.position, groundCheckRadius, groundLayerMask);
}

方案2：CharacterController自带检测（若使用该组件） #

如果玩家用了Unity的CharacterController组件，直接用官方封装的检测逻辑：

private CharacterController controller;

void Awake()
{
    controller = GetComponent<CharacterController>();
}

bool IsGrounded()
{
    return controller.isGrounded;
}

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