UniTask进阶指南：5个你可能不知道的任务取消技巧（Unity异步编程避坑）-CSDN博客

UniTask进阶指南：5个你可能不知道的任务取消技巧（Unity异步编程避坑）

如果你已经用UniTask写过一些异步逻辑，体验过它带来的流畅与便捷，那么恭喜你，你已经迈出了高效Unity开发的重要一步。但异步编程的世界远不止async和await那么简单，尤其是在复杂的游戏逻辑、资源加载、网络请求交织的场景下，如何优雅、安全地“叫停”一个正在执行的任务，往往成为区分普通使用者和高阶开发者的分水岭。任务取消（Cancellation）不是简单的Cancel()调用，它关乎内存管理、异常处理、资源回收和代码健壮性。这篇文章，我想和你深入聊聊那些在官方文档里可能一笔带过，但在实际生产环境中却至关重要的任务取消技巧。无论你是在构建一个需要随时中断的过场动画，一个可取消的寻路系统，还是一个需要精细控制的后台加载流程，理解这些技巧都能让你避免许多深夜调试的“坑”。

1. 超越基础的CancellationTokenSource：理解生命周期与作用域

很多开发者知道要传CancellationToken，也记得调用Cancel()，但内存泄漏和无效取消往往源于对CancellationTokenSource生命周期的误解。它不仅仅是一个“取消信号发射器”，更是一个需要被妥善管理的资源。

1.1 作用域决定一切：局部、类级与全局

CancellationTokenSource的创建位置，直接决定了它的控制粒度和生命周期。

局部作用域：在方法内部创建，通常用于控制该单一方法内部启动的异步操作。这是最安全、最推荐的方式，因为它确保了当方法执行完毕（或超出预期）时，与之关联的取消源可以被及时回收。

public async UniTask LoadSceneWithTimeout(string sceneName, float timeoutSeconds)
{
    // 为这次特定的加载操作创建一个专属的CTS
    using (var cts = new CancellationTokenSource())
    {
        // 设置超时自动取消
        cts.CancelAfterSlim(TimeSpan.FromSeconds(timeoutSeconds));

        try
        {
            await SceneManager.LoadSceneAsync(sceneName)
                .ToUniTask(cancellationToken: cts.Token);
            Debug.Log("场景加载成功");
        }
        catch (OperationCanceledException)
        {
            Debug.LogWarning($"场景加载在{timeoutSeconds}秒后超时取消");
            // 这里可以进行超时后的清理工作，例如隐藏加载界面
        }
    } // using语句结束，cts.Dispose()被自动调用
}

注意：使用using语句是管理局部CancellationTokenSource生命周期的黄金法则，它能确保即使发生异常，Dispose也会被调用，避免资源泄漏。

类级作用域：作为类的成员变量。这适用于需要从类外部（如其他方法、UI事件）控制的长生命周期任务，例如一个持续播放的背景音乐管理器或一个游戏角色的持续行为。

public class PlayerMovementController : MonoBehaviour
{
    private CancellationTokenSource _movementCts;

    public void StartComplexMovement(Vector3 target)
    {
        // 开始新移动前，取消可能存在的旧移动任务
        _movementCts?.Cancel();
        _movementCts?.Dispose();
        _movementCts = new CancellationTokenSource();

        _ = ExecuteMovementAsync(target, _movementCts.Token);
    }

    private async UniTaskVoid ExecuteMovementAsync(Vector3 target, CancellationToken ct)
    {
        // 复杂的移动逻辑...
        while (!ct.IsCancellationRequested && Vector3.Distance(transform.position, target) > 0.1f)
        {
            // 每帧移动一点点
            await UniTask.Yield(PlayerLoopTiming.Update, ct);
        }
    }

    private void OnDestroy()
    {
        // MonoBehaviour销毁时，务必清理类级CTS
        _movementCts?.Cancel();
        _movementCts?.Dispose();
    }
}

这里的关键在于，类级CancellationTokenSource的生命周期必须与持有它的对象（通常是MonoBehaviour）绑定。在OnDestroy中清理是必须的。

全局/静态作用域：谨慎使用。除非是管理整个应用程序级别的后台任务（如全局的资源预加载队列），否则极易造成难以追踪的依赖和内存泄漏。如果必须使用，一定要有清晰的、集中的清理入口。

1.2 链接Token：构建灵活的取消链

有时，一个任务需要响应多种取消信号：比如用户手动取消 + 系统超时取消。CancellationTokenSource.CreateLinkedTokenSource 是你的得力工具。它可以创建一个新的CancellationTokenSource，当传入的任何一个CancellationToken被取消时，它也会被取消。

public async UniTask DownloadAssetBundleWithControls(string url, CancellationToken userCancellationToken)
{
    // 创建一个链接Token源，同时监听用户取消和内部超时
    using (var linkedCts = CancellationTokenSource.CreateLinkedTokenSource(
        userCancellationToken,
        new CancellationTokenSource(TimeSp