Unity 3D：3D胶囊体沿墙体攀爬失效的问题修复方法

你的代码存在几个关键问题导致胶囊体无法持续沿墙体上升，以下是问题分析和修复方案：

问题点 #

1. 生命周期方法未执行：start()方法首字母小写，Unity的生命周期方法要求首字母大写（Start()），因此初始化代码不会被调用，riseSpeed可能未被正确赋值。
2. 碰撞检测仅触发一次：OnCollisionEnter只在碰撞开始时执行一次，只能给刚体施加一次速度，无法实现持续攀爬。
3. 速度覆盖导致异常：直接设置rb.velocity = transform.up * riseSpeed会完全覆盖刚体的原有速度（比如重力），可能导致胶囊体脱离墙体或物理行为异常。
4. 无输入触发逻辑：当前代码只要碰到墙就自动攀爬，不符合常规游戏交互逻辑。

修复后的代码 #

using System.Collections;
using System.Collections.Generic;
using UnityEngine;

public class WallClimb : MonoBehaviour
{
    public float riseSpeed = 5.0f;
    public Rigidbody rb;
    public KeyCode climbTriggerKey = KeyCode.Space; // 自定义攀爬触发键

    private void Start()
    {
        // 自动获取Rigidbody组件，避免Inspector手动赋值遗漏
        if (rb == null)
        {
            rb = GetComponent<Rigidbody>();
        }
    }

    private void OnCollisionStay(Collision collision)
    {
        // 仅在接触墙体且按下攀爬键时触发攀爬
        if (collision.gameObject.CompareTag("Wall") && Input.GetKey(climbTriggerKey))
        {
            // 只修改Y轴速度，保留刚体其他方向的运动状态
            Vector3 adjustedVelocity = rb.velocity;
            adjustedVelocity.y = riseSpeed;
            rb.velocity = adjustedVelocity;

            Debug.Log("正在沿墙体攀爬");
        }
    }
}

额外注意事项 #

• 确保胶囊体的Rigidbody组件未锁定Y轴移动（在Inspector的Constraints面板中检查）。
• 墙体必须带有Collider组件，且未勾选Is Trigger，否则碰撞检测不会生效。
• 如需适配斜墙攀爬，可以通过collision.contacts[0].normal获取墙体法线，计算贴合墙体的攀爬方向，替换transform.up。

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