Unity 3D斜坡移动产生颠簸运动的问题求助

各位Unity开发者们好，最近跟着一套教程做第一人称视角游戏，这套教程不算特别老旧，但里面的代码已经有些过时了。我靠翻评论区的内容改了一部分问题，但目前卡在了斜坡移动的bug上，实在没辙了来求助大家：

• 当我操控角色上坡的时候，移动逻辑完全正常，和教程预期的效果一致
• 但一旦切换到下坡，角色的移动就变得特别诡异——具体表现是会出现明显的颠簸感，有时候甚至会突然卡一下，仿佛地面有看不见的障碍一样

原教程的核心思路是：通过检测角色是否站在斜坡上，来调整移动行为（比如限制移动方向贴合斜坡）。我怀疑问题出在斜坡检测的逻辑或者下坡时的重力/速度处理上，但自己排查了好半天没找到关键点。

目前我猜测可能的问题方向：

• 地面检测的射线参数（比如长度、检测层）设置不合理，导致下坡时频繁触发“离开斜坡/回到斜坡”的检测，引发颠簸
• 下坡时的移动向量没有正确和斜坡法线做投影，导致角色移动时和地面产生穿模或者碰撞冲突
• 用了过时的CharacterController相关API，新旧版本的行为差异导致逻辑冲突

我贴一下当前处理斜坡的核心代码片段，方便大家帮忙排查：

// 这是我修改后的斜坡处理核心逻辑
private void HandleSlopeMovement()
{
    RaycastHit hit;
    // 向下发射射线检测地面
    if (Physics.Raycast(transform.position, Vector3.down, out hit, 1.2f, groundLayerMask))
    {
        float slopeAngle = Vector3.Angle(hit.normal, Vector3.up);
        // 如果超过最大允许斜坡角度，调整移动方向
        if (slopeAngle > maxWalkableSlope)
        {
            moveDirection = Vector3.ProjectOnPlane(moveDirection, hit.normal);
        }
    }
    // 执行移动
    characterController.Move(moveDirection * Time.deltaTime);
}

补充说明：这段代码在上坡时能让角色稳稳贴合斜坡，但下坡时角色就会一颠一颠的，感觉像是每帧都在“撞地面”一样。

有没有大佬遇到过类似的情况？或者能帮我分析下问题可能出在哪？也可以给我推荐下适配现代Unity版本的斜坡移动处理方法，感激不尽！

内容来源于stack exchange