Unity中IEnumerator实现武器连射与换弹功能故障求助

我刚接触Unity，正在学习使用IEnumerator，写的3D武器脚本完全没法正常工作。预期功能是：

• 从指定位置生成投射物克隆体
• 按fireRate设置的延迟持续射击，直到ammoLeftInClip（弹夹剩余弹药）降到0
• 弹夹空了之后调用另一个IEnumerator，按timeToReload时长完成换弹

当前脚本代码：

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

public class Weapon : MonoBehaviour
{
    // variables
    [Header("Weapon")]
    public float fireRate = 0.5f;
    public float timeToReload = 3.5f;

    [Header("Ammo")]
    public float ammoLeftInClip = 0;
    public float clipAmount = 4;
    public float ammoInClips = 90;

    [Header("Bullet")]
    public GameObject projectile;

    private void Start()
    {
        ammoLeftInClip = ammoInClips;
        clipAmount--;
    }

    public void Update()
    {
        if (Input.GetKeyDown(KeyCode.Mouse0))
        {
            print("IEnum 'fireWeapon' is being called");
            fireWeapon();
        }
    }

    IEnumerator fireWeapon()
    {
        if (ammoLeftInClip >= 1){
            print("Firing");
            var clone = Instantiate(projectile, gameObject.transform.position, gameObject.transform.rotation);
            Destroy(clone, 5.0f);
            ammoLeftInClip--;
        } else if (ammoLeftInClip <= 0){
            print("reload() is being called");
            ammoLeftInClip = 0;
            reload();
        }
        print("IEnum 'fireWeapon' is being called");
        yield return new WaitForSeconds(fireRate);
    }

    private void reload()
    {
        if (clipAmount >= 1)
        {
            print("IEnum 'reloadWeapon' is being called");
            reloadWeapon();
        }
    }

    IEnumerator reloadWeapon()
    {
        new WaitForSeconds(timeToReload);
        clipAmount--;
        yield return ammoLeftInClip = ammoInClips;
    }
}

我试过把射击逻辑移到独立函数里，调整后只能生成投射物，其他功能还是不行：

if (ammoLeftInClip >= 1){
    print("Firing");
    var clone = Instantiate(projectile, gameObject.transform.position, gameObject.transform.rotation);
    Destroy(clone, 5.0f);
    ammoLeftInClip--;
} else if (ammoLeftInClip <= 0){
    print("reload() is being called");
    ammoLeftInClip = 0;
    reload();
}

你的脚本核心问题都出在IEnumerator的使用逻辑和流程控制上，逐个修正如下：

1. 调用协程必须用StartCoroutine #

Unity里不能直接调用IEnumerator方法，必须通过StartCoroutine()启动，否则协程逻辑根本不会执行。比如：

• Update里的fireWeapon()要改成StartCoroutine(fireWeapon())
• reload()里的reloadWeapon()要改成StartCoroutine(reloadWeapon())

2. fireWeapon缺少循环，无法持续射击 #

当前fireWeapon只执行一次射击就结束，要实现持续射击到弹夹空，得在协程里加循环，同时把Input.GetKeyDown改成Input.GetKey（前者只触发一次，后者按住会持续响应）。

修改后的fireWeapon：

IEnumerator fireWeapon()
{
    // 循环条件：按住左键 + 弹夹有弹药 + 不在换弹中
    while (Input.GetKey(KeyCode.Mouse0) && ammoLeftInClip > 0)
    {
        print("Firing");
        Instantiate(projectile, transform.position, transform.rotation);
        ammoLeftInClip--;
        // 等待fireRate后再射下一发
        yield return new WaitForSeconds(fireRate);
    }
    // 弹夹空了自动触发换弹
    if (ammoLeftInClip <= 0)
    {
        StartCoroutine(reloadWeapon());
    }
}

3. reloadWeapon协程逻辑错误 #

• new WaitForSeconds(timeToReload)没有加yield return，等于没加延迟，换弹会瞬间完成
• yield return ammoLeftInClip = ammoInClips是错误用法，yield return是用来等待的，赋值要放在延迟之后

修改后的reloadWeapon：

IEnumerator reloadWeapon()
{
    // 先等换弹时间
    yield return new WaitForSeconds(timeToReload);
    // 检查还有备用弹夹
    if (clipAmount > 0)
    {
        clipAmount--;
        // 填满当前弹夹
        ammoLeftInClip = ammoInClips;
        print("换弹完成");
    }
    else
    {
        print("没有备用弹夹了");
    }
}

4. 初始弹药逻辑错误 #

Start里的ammoLeftInClip = ammoInClips是把总弹药量赋值给弹夹剩余，逻辑错误——应该给弹夹设一个单独的容量（比如clipSize），ammoInClips作为总备用弹药。另外初始的clipAmount--也不合理，应该保留初始备用弹夹数。

修正Start方法（先加一个弹夹容量变量）：

// 在Ammo区域加一个变量
public int clipSize = 30; // 单弹夹容量

private void Start()
{
    // 初始填满弹夹
    ammoLeftInClip = clipSize;
    // 备用弹夹数保持初始值，不用减1
}

5. 避免重复触发协程 #

加一个isReloading布尔变量，防止换弹时还能触发射击：

private bool isReloading = false;

// 在fireWeapon的循环条件里加!isReloading
while (Input.GetKey(KeyCode.Mouse0) && ammoLeftInClip > 0 && !isReloading)

// 在reloadWeapon里控制状态
IEnumerator reloadWeapon()
{
    if (isReloading) yield break;
    isReloading = true;
    yield return new WaitForSeconds(timeToReload);
    // ...换弹逻辑
    isReloading = false;
}

完整修复后的脚本 #

using System.Collections;
using UnityEngine;

public class Weapon : MonoBehaviour
{
    [Header("Weapon")]
    public float fireRate = 0.5f;
    public float timeToReload = 3.5f;

    [Header("Ammo")]
    public int clipSize = 30;
    public int ammoLeftInClip = 0;
    public int clipAmount = 4;
    public int ammoInTotal = 90;

    [Header("Bullet")]
    public GameObject projectile;

    private bool isReloading = false;

    private void Start()
    {
        ammoLeftInClip = clipSize;
    }

    private void Update()
    {
        // 按住左键射击，按R键手动换弹
        if (Input.GetKeyDown(KeyCode.Mouse0) && !isReloading)
        {
            StartCoroutine(fireWeapon());
        }
        if (Input.GetKeyDown(KeyCode.R) && ammoLeftInClip < clipSize && !isReloading)
        {
            StartCoroutine(reloadWeapon());
        }
    }

    IEnumerator fireWeapon()
    {
        while (Input.GetKey(KeyCode.Mouse0) && ammoLeftInClip > 0 && !isReloading)
        {
            Instantiate(projectile, transform.position, transform.rotation);
            ammoLeftInClip--;
            yield return new WaitForSeconds(fireRate);
        }

        // 弹夹空了自动换弹
        if (ammoLeftInClip <= 0 && !isReloading)
        {
            StartCoroutine(reloadWeapon());
        }
    }

    IEnumerator reloadWeapon()
    {
        if (isReloading || clipAmount <= 0) yield break;
        
        isReloading = true;
        print("正在换弹...");
        
        yield return new WaitForSeconds(timeToReload);
        
        // 消耗一个备用弹夹，填满当前弹夹
        clipAmount--;
        ammoLeftInClip = clipSize;
        
        print("换弹完成");
        isReloading = false;
    }
}

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