Unity中UniTask异步方法与非异步返回UniTask的用法及并行加载疑问

你的测试代码 #

private async UniTask LoadGameAsync()
{
    //this should be the right way to await the scene loading
    await LoadSceneAsync("Level_01");
    Debug.Log("Level 01 finished loading.");
    
    //does this work?
    //I'm uncertain if this is correct because I await a non async method. But then again it returns a task ... No compiler error.
    await LoadScene("Level_02");
    Debug.Log("Level 02 finished loading.");
    
    //why all this?
    //because I want to load multiple scenes simultaneously and only when all are finished loading, hide a loading screen.
    //Does this work the way I intend to or are there pitfalls to avoid? If so, what's the correct way of implementing something like this?
    UniTask level03Task = LoadScene("Level_03");
    UniTask level03UITask = LoadScene("Level_03_UI");
    await UniTask.WhenAll(level03Task, level03UITask);
    Debug.Log("Level 03 and its UI finished loading, hide loading screen now.");
}

private async UniTask LoadSceneAsync(string sceneName)
{
    await SceneManager.LoadSceneAsync(sceneName).ToUniTask();
}

private UniTask LoadScene(string sceneName)
{
    return SceneManager.LoadSceneAsync(sceneName).ToUniTask();
}

疑问解答 #

1. 能否await非async但返回UniTask的方法？ #

完全可以，这不仅合法，还是更高效的推荐写法。

• await的核心是等待一个实现了异步等待接口的对象，和方法是否标记async无关。async关键字只是让编译器自动生成状态机，处理异步流程的暂停和恢复。
• 你的LoadScene方法直接返回ToUniTask()的结果，没有多余的状态机开销；而LoadSceneAsync因为加了async，反而会生成不必要的状态机（方法内只有一个await，无后续逻辑），性能略差。

2. UniTask.WhenAll并行加载场景是否符合预期？ #

写法逻辑没问题，但有几个关键陷阱必须规避：

核心陷阱：场景加载模式

SceneManager.LoadSceneAsync默认是LoadSceneMode.Single模式（会卸载当前所有场景），这种模式下无法并行加载多个场景——后面的加载会直接覆盖前面的。必须改成LoadSceneMode.Additive模式才能实现并行加载。

其他注意事项

• 任务取消：建议使用UniTask提供的生命周期取消令牌（比如this.GetCancellationTokenOnDestroy()），响应用户取消操作，避免内存泄漏。
• 错误处理：如果任意一个场景加载失败，UniTask.WhenAll会直接抛出异常，需要用try-catch捕获，避免整个流程崩溃。

修正后的并行加载代码

private async UniTask LoadGameAsync()
{
    // ... 前面的串行加载逻辑 ...

    try
    {
        // 获取绑定当前对象生命周期的取消令牌
        var cancellationToken = this.GetCancellationTokenOnDestroy();
        
        // 启动两个并行的场景加载任务
        UniTask level03Task = LoadScene("Level_03", cancellationToken);
        UniTask level03UITask = LoadScene("Level_03_UI", cancellationToken);
        
        // 等待所有任务完成
        await UniTask.WhenAll(level03Task, level03UITask);
        Debug.Log("Level 03和其UI加载完成，隐藏加载界面");
    }
    catch (OperationCanceledException)
    {
        Debug.Log("加载已取消");
    }
    catch (Exception e)
    {
        Debug.LogError($"加载失败：{e.Message}");
    }
}

// 改造后的LoadScene方法，指定Additive模式并支持取消令牌
private UniTask LoadScene(string sceneName, CancellationToken ct = default)
{
    return SceneManager.LoadSceneAsync(sceneName, LoadSceneMode.Additive)
                       .ToUniTask(cancellationToken: ct);
}

3. UniTask是结构体（值类型）对任务创建的影响？ #

几乎没有负面影响，反而是UniTask针对Unity优化的核心优势之一：

• 无GC分配：结构体是值类型，不会在堆上分配内存，减少Unity运行时的GC压力，对性能敏感的游戏场景至关重要。
• 注意事项：不要重复await同一个UniTask实例（或其复制实例）。虽然重复await不会导致任务重复执行，但会让代码逻辑混乱，遵循“一个任务只await一次”的原则即可。
• UniTask的结构体设计已经做了完善处理（比如已完成任务的缓存、空任务的默认值），使用体验和类类型的Task几乎完全一致，无需额外适配。

内容的提问来源于stack exchange，提问作者Meister der Magie