游戏客户端架构 / 系统课时
角色下坡为什么会持续弹起
角色下坡为什么会持续弹起
角色沿斜坡向下移动时,如果不断离地、下落、重新碰撞并再次弹起,通常说明接地检测、坡面移动、重力或碰撞修正之间存在反馈循环。本课以 Unity CharacterController 为例,通过最小可运行控制器复现并分析下坡问题,建立一套可验证的修复方法。
学习目标
- 解释下坡时角色反复失去接地状态的原因。
- 理解坡面法线、重力和贴地速度之间的关系。
- 实现并验证基础的斜坡移动与接地处理。
为什么下坡比上坡更容易离地
在平地上,角色水平移动时地面的高度基本不变;但在下坡时,下一帧角色脚下的地面会更低。如果移动控制器只执行水平位移,角色可能暂时悬在坡面上方。
随后重力让角色下落,碰撞系统使角色重新贴近地面。如果接地后立即把竖直速度清零,而移动逻辑又继续忽略坡面方向,下一次水平移动仍可能造成新的离地间隙。
问题由此形成循环:水平位移造成离地、重力加速下落、重新接触坡面、竖直速度重置,再次水平位移。表现出来就是角色沿坡面连续小幅跳动。

需要注意,CharacterController.isGrounded 表示上一次 Move 调用期间控制器是否接触到下方地面,并非持续实时检测的传感器。如果一帧调用多次 Move,最后一次调用的结果也可能改变后续接地判断。
坡面法线如何影响移动方向
要让角色沿坡面移动,需要知道坡面的朝向。通过向下射线检测可以得到 RaycastHit.normal,也就是碰撞表面的单位法线。
将预期水平移动方向投影到坡面切平面,可以得到沿坡面的移动方向:
Vector3 slopeDirection = Vector3.ProjectOnPlane(inputDirection, groundNormal);这是片段示例:inputDirection 是世界空间中的期望水平方向,groundNormal 是有效坡面法线,完整上下文见后面的控制器代码。
投影结果在下坡方向上通常包含向下的竖直分量,使角色更自然地跟随下降坡面。

不过,不能把射线命中的所有表面都当作可行走地面。墙面、陡坡和台阶边缘也可能产生法线,投影前应检查坡面角度是否处于控制器允许的范围内。
同时,射线检测与 CharacterController 自身的胶囊碰撞求解并不完全相同。射线用于估计坡面朝向,不应该无条件覆盖实际碰撞结果。
实现一个可验证的下坡控制器
在 Unity 3D 场景中创建地面和斜坡,为地形保留 Collider,并创建带 CharacterController 组件的角色对象。这个示例使用旧版 Input API,需要在项目的 Active Input Handling 中启用 Input Manager 或 Both。
将以下脚本保存为 DownhillController.cs 并挂到角色根节点,角色移动由该脚本统一管理,不要同时挂载另一个移动脚本或 Rigidbody 驱动脚本。
using UnityEngine;
[RequireComponent(typeof(CharacterController))]
public class DownhillController : MonoBehaviour
{
[SerializeField] private float speed = 4f;
[SerializeField] private float gravity = -20f;
[SerializeField] private float groundStickSpeed = -2f;
[SerializeField] private float probeDistance = 0.5f;
[SerializeField] private LayerMask groundMask = ~0;
private CharacterController controller;
private float verticalSpeed;
private void Awake()
{
controller = GetComponent<CharacterController>();
}
private void Update()
{
float x = Input.GetAxisRaw("Horizontal");
float z = Input.GetAxisRaw("Vertical");
Vector3 input = Vector3.ClampMagnitude(new Vector3(x, 0f, z), 1f);
Vector3 worldDirection = transform.TransformDirection(input);
// 射线起点抬高,减少起点恰好位于地面内部的情况。
Vector3 origin = transform.position + Vector3.up * 0.2f;
bool foundGround = Physics.Raycast(
origin, Vector3.down, out RaycastHit hit,
controller.height * 0.5f + probeDistance,
groundMask, QueryTriggerInteraction.Ignore);
Vector3 moveDirection = worldDirection;
if (foundGround)
{
float angle = Vector3.Angle(hit.normal, Vector3.up);
if (angle <= controller.slopeLimit)
{
// 只在可行走坡面上沿切平面修正移动方向。
moveDirection = Vector3.ProjectOnPlane(worldDirection, hit.normal);
if (moveDirection.sqrMagnitude > 0.0001f)
moveDirection = moveDirection.normalized * input.magnitude;
}
}
// 接地时保留小幅向下速度,减少坡面下降导致的离地间隙。
if (controller.isGrounded && verticalSpeed < 0f)
verticalSpeed = groundStickSpeed;
else
verticalSpeed += gravity * Time.deltaTime;
Vector3 velocity = moveDirection * speed + Vector3.up * verticalSpeed;
CollisionFlags flags = controller.Move(velocity * Time.deltaTime);
if ((flags & CollisionFlags.Below) != 0 && verticalSpeed < 0f)
verticalSpeed = groundStickSpeed;
}
}这个实现只负责基础地面行走,不包含跳跃、滑坡、移动平台和台阶吸附。groundStickSpeed 是接地时使用的轻微向下速度,不是向上弹跳的补偿值;groundMask 应只包含可作为地面的碰撞层,避免射线命中角色自身或无关障碍物。
代码将坡面投影速度与重力速度合并后调用一次 Move,避免多个控制模块分别移动同一个 CharacterController。但投影可能已经包含竖直分量,因此在陡坡或复杂地形中,还需检查叠加后的下降速度与期望移动速度是否一致。
预期结果:运行后使用方向键或 WASD 控制角色,在坡度小于 Slope Limit、碰撞体设置合理的斜坡上,角色应能向下移动,并显著减少因水平位移而反复离地的现象。此示例没有主动输出日志,验收依据是 Scene 视图中的接地轨迹和角色移动表现。
接地检测与碰撞修正的边界
即使加入坡面投影和贴地速度,也不意味着所有下坡弹跳都会消失。控制器底部的胶囊形状、Skin Width、Step Offset 和地形几何形状都会影响最终碰撞结果。
排查时应区分以下情况:
| 现象 | 可能原因 | 优先处理 |
|---|---|---|
| 只在坡面开始下降时短暂悬空 | 没有沿坡移动或缺乏贴地速度 | 检查坡面投影和接地处理 |
| 下坡时接地状态连续切换 | 检测距离过短、胶囊边界不合适 | 检查射线范围与 CharacterController 尺寸 |
| 坡度较大时角色被不断推出 | 超过允许坡度或穿入碰撞体 | 检查 Slope Limit 和碰撞几何 |
| 到坡面接缝处突然弹起 | 接缝台阶、碰撞网格不连续 | 检查 MeshCollider 和地形连接 |
| 修改贴地速度后异常加剧 | 下降速度过大、碰撞修正反复发生 | 降低贴地速度并检查单次 Move 的结果 |
特别要避免将 isGrounded 为 false 直接等同于角色正在跳跃。在坡面边缘、下降地形和物理接触尚未恢复时,短时间的离地状态可能只是正常运动结果。
实际项目可以进一步增加短距离地面探测和短暂接地宽限,但应明确地面检测是对状态的估计,而不是直接修改 Transform 高度的理由。
验证修复是否真正稳定
建议准备平地、缓坡、接近 Slope Limit 的斜坡以及含有接缝的坡面,保持相同移动速度完成对照测试。
- 在平地上静止并移动,确认角色没有额外下沉或漂移。
- 沿缓坡连续向下移动,观察脚部与地面的距离是否稳定。
- 沿同一坡面向上移动,检查投影逻辑是否引入异常速度。
- 在陡坡和边缘停止输入,检查是否出现持续碰撞修正。
- 使用不同帧率重复测试,确认没有明显的帧率依赖。
如果问题仍然存在,先关闭坡面投影,只保留重力与单次 Move,再逐项恢复投影、接地检测和贴地速度。一次只改变一个条件,才能确定是哪一个反馈环节造成异常。
下坡移动稳定性的关键不是将角色强制吸附到地面,而是让移动方向、接地估计与碰撞求解彼此协调。保持单一移动入口、合理的坡面法线判断以及适度的向下速度,才能在不破坏跳跃和边缘行为的前提下减少弹跳。