Unity移动脚本实现重力报错：无法将float转换为Vector3

第一人称项目移动模块实现重力功能时，编写如下ProcessMove逻辑后触发编译错误：

public void ProcessMove(Vector2 input)
    {
        Vector3 moveDirection = Vector3.zero;
        moveDirection.x = input.x;
        moveDirection.z = input.y;
        controller.Move(transform.TransformDirection(moveDirection) * speed * Time.deltaTime);
        float playerVelocity.y += gravity * Time.deltaTime;
        if(isGrounded && playerVelocity.y > 0){
            playerVelocity.y = -2f;
        }   
        controller.Move(playerVelocity.y * Time.deltaTime);
    }    

编译报错信息：

Assets\Scripts\PlayerMotor.cs(34,25): error CS1503: Argument 1: cannot convert from 'float' to 'UnityEngine.Vector3'

代码共存在3处问题，直接触发编译报错的是参数类型不匹配问题：

• 语法错误：float playerVelocity.y += gravity * Time.deltaTime; 属于非法写法，playerVelocity是存储三维速度的Vector3类型变量，访问其分量赋值时不能额外加float类型声明，该写法会导致编译器无法正确识别变量类型。
• 类型不匹配：Unity中CharacterController.Move()方法的入参要求是Vector3类型的三维移动增量，但第二次调用Move时传入的playerVelocity.y * Time.deltaTime是float类型值，完全不符合参数要求，直接抛出CS1503错误。
• 逻辑缺陷：两次独立调用controller.Move()会拆分水平、竖直移动的碰撞计算，容易出现穿模、碰撞检测失效问题；同时接地判断条件playerVelocity.y > 0逻辑写反，重力作用下玩家下落时竖直速度为负值，原判断永远无法在落地时触发速度重置。

1. 将playerVelocity声明为类级别的Vector3类型成员变量，不要在方法内给分量赋值时重复声明类型
2. 竖直移动量使用完整的Vector3类型传递，不要只传y轴的float值
3. 合并水平、竖直方向的移动增量，单次调用Move方法完成移动计算，同时修正接地判断的条件逻辑

修正后的可运行代码：

// 类层面声明成员变量
private Vector3 playerVelocity;
public float gravity = -9.81f;
public float moveSpeed = 5f;
public CharacterController controller;
public bool isGrounded;

public void ProcessMove(Vector2 input)
{
    // 计算水平方向移动
    Vector3 moveDir = Vector3.zero;
    moveDir.x = input.x;
    moveDir.z = input.y;
    Vector3 horizontalDelta = transform.TransformDirection(moveDir) * moveSpeed * Time.deltaTime;

    // 计算重力影响的竖直速度
    playerVelocity.y += gravity * Time.deltaTime;
    // 接地时重置竖直速度，避免重力无限累加
    if (isGrounded && playerVelocity.y < 0)
    {
        playerVelocity.y = -2f;
    }
    Vector3 verticalDelta = playerVelocity * Time.deltaTime;

    // 合并移动量，单次传入Vector3参数完成移动
    controller.Move(horizontalDelta + verticalDelta);
}

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