Unity 异步编程:协程、async/await、UniTask 与 Awaitable

2774 字
14 分钟
Unity 异步编程:协程、async/await、UniTask 与 Awaitable

协程和 async/await 在语言层面的原理(编译器生成的状态机),见 C# 迭代器与 async/await 原理。

一、为什么需要异步#

游戏中有大量”需要等一会儿”的逻辑:

  • 等资源加载完成、等网络请求返回;
  • 延迟 2 秒后执行、每隔 1 秒执行一次;
  • 先播动画,播完再弹出奖励,再等玩家点击……

这些逻辑不能用循环加等待来写,因为 Unity 的脚本都运行在主线程上,一旦阻塞,整个游戏就卡住了。异步方案要解决的是:把一段跨越多帧的流程,写成顺序执行的代码,同时不阻塞主线程。

Unity 中有四种主要方案:

方案来源基础
协程(Coroutine)Unity 内置C# 迭代器
async/await + TaskC# / .NETasync 状态机 + Task
UniTask第三方开源(Cysharp)async 状态机 + 自定义的结构体任务类型
AwaitableUnity 2023.1 起内置async 状态机 + Unity 官方的任务类型

二、协程#

运行机制#

IEnumerator ShowReward()
{
PlayAnimation();
yield return new WaitForSeconds(1f); // 1 秒后再继续
OpenRewardPopup();
yield return null; // 下一帧再继续
PlaySound();
}
StartCoroutine(ShowReward());
  1. StartCoroutine 会立即执行协程,直到第一个 yield return。
  2. Unity 记下 yield 出来的对象,在之后的每一帧检查条件是否满足。
  3. 条件满足时调用迭代器的 MoveNext(),执行到下一个 yield return,如此往复,直到方法结束。

yield 指令与执行时机#

yield 返回什么时候继续
null下一帧,在所有 Update 执行完之后
new WaitForSeconds(t)经过 t 秒(受 Time.timeScale 影响)后的那一帧,在 Update 之后
new WaitForSecondsRealtime(t)经过 t 秒真实时间,不受 timeScale 影响
new WaitForFixedUpdate()下一次 FixedUpdate 之后
new WaitForEndOfFrame()当前帧渲染完成、显示到屏幕之前,适合截屏
new WaitUntil(条件) / WaitWhile每帧检查条件,在 Update 之后、LateUpdate 之前
AsyncOperation(如场景、资源异步加载)操作完成后
StartCoroutine(另一个协程)等待另一个协程结束
yield break立即结束协程

暂停游戏时常把 Time.timeScale 设为 0,这时 WaitForSeconds 永远不会结束。暂停界面中的倒计时、动画要用 WaitForSecondsRealtime。

生命周期#

协程依附于启动它的 MonoBehaviour:

操作协程会怎样
gameObject.SetActive(false)停止,重新激活后也不会恢复
Destroy(gameObject) 或销毁组件停止
enabled = false(只禁用组件)不会停止,继续运行
StopCoroutine(handle) / StopAllCoroutines()停止

物体被禁用后协程不会恢复,这一点经常导致”界面关掉又打开,倒计时不走了”的 Bug,需要在 OnEnable 中重新启动。

GC 分配#

  • 每次 StartCoroutine 都会创建一个迭代器对象和一个 Coroutine 对象。
  • yield return new WaitForSeconds(1) 每次都会 new 一个对象,可以缓存复用:
static readonly WaitForSeconds OneSecond = new WaitForSeconds(1f);
yield return OneSecond;
  • yield return 0 会把 int 装箱,用 yield return null 代替。

局限#

  • 不能返回值:想拿到协程的结果,只能通过回调或者成员变量。
  • 异常处理困难:yield return 不能放在带 catch 的 try 中;协程中抛出的异常只会输出到日志,并终止这个协程,外部无从得知。
  • 取消不方便:只能通过保存 Coroutine 句柄来 StopCoroutine,嵌套的子协程管理起来很麻烦。
  • 必须依附 MonoBehaviour:普通的 C# 类中无法直接启动协程。

三、原生 async/await 与 Task#

Unity 在主线程上安装了 UnitySynchronizationContext,所以在主线程中 await 之后,代码会回到主线程继续执行,可以调用 Unity API:

async void Start()
{
await Task.Delay(1000);
transform.position = Vector3.zero; // 回到了主线程,可以调用
}

写法比协程自然很多:有返回值、可以 try/catch、可以在任何类中使用。但在 Unity 中直接使用 Task 有几个坑:

问题说明
不受对象生命周期管理物体被销毁后,await 之后的代码照样执行,访问已销毁的对象就会报 MissingReferenceException
退出 Play 模式后仍在运行编辑器中停止运行后,没结束的 Task 还会继续执行
不受 timeScale 影响Task.Delay 用的是系统计时器,游戏暂停时它照样计时
GC 分配每个 Task 都是对象,频繁使用会产生 GC
异常被吞没被 await 的 Task 中抛出的异常,不会出现在日志里
WebGL 不支持多线程Task.Run 等依赖线程的用法不能用

所以在 Unity 中写游戏逻辑,一般不直接使用 Task,而是使用 UniTask 或 Awaitable。原生 Task 主要用于和 .NET 类库交互。

四、UniTask#

UniTask 是专为 Unity 设计的 async/await 方案,是目前 Unity 项目中最常用的异步库。

为什么快#

  • UniTask 和 UniTask<T> 是结构体,并且配套了自定义的状态机构建器。同步完成时零分配,需要暂停时使用对象池复用内部对象,基本不产生 GC。
  • 不依赖 SynchronizationContext,而是直接挂在 Unity 的 PlayerLoop 上运行,每帧在指定的时机检查和推进。可以精确控制在 Update、LateUpdate、FixedUpdate 等哪个阶段继续执行。

常用 API#

// 等待时间与帧
await UniTask.Delay(1000); // 受 timeScale 影响
await UniTask.Delay(1000, ignoreTimeScale: true); // 不受影响
await UniTask.Yield(); // 等到下一次 PlayerLoop
await UniTask.NextFrame(); // 下一帧
await UniTask.WaitForFixedUpdate();
await UniTask.WaitUntil(() => isReady);
// 直接 await Unity 的异步操作
var asset = await Resources.LoadAsync<Sprite>("Icon");
await SceneManager.LoadSceneAsync("Battle");
var request = await UnityWebRequest.Get(url).SendWebRequest();
// 并行
await UniTask.WhenAll(LoadA(), LoadB(), LoadC());
var (winIndex, result) = await UniTask.WhenAny(TaskA(), TaskB());
// 切换线程
await UniTask.SwitchToThreadPool(); // 之后在线程池执行
HeavyCompute();
await UniTask.SwitchToMainThread(); // 回到主线程
// 不需要等待结果的"发射后不管"
DoSomethingAsync().Forget();

方法声明:

async UniTask LoadAsync() { ... } // 无返回值
async UniTask<int> GetCountAsync() { ... } // 有返回值
async UniTaskVoid OnClickAsync() { ... } // 代替 async void

绑定生命周期:取消#

UniTask 最重要的用法,是把异步流程和对象的生命周期绑定:

async UniTaskVoid Start()
{
var token = this.GetCancellationTokenOnDestroy(); // 物体销毁时自动取消
await UniTask.Delay(3000, cancellationToken: token);
transform.position = Vector3.zero; // 物体已销毁时不会执行到这里
}

物体销毁时,正在等待的 Delay 会抛出 OperationCanceledException,后面的代码不再执行。这就解决了原生 Task “对象销毁后还在跑”的问题。

注意事项#

  • 一个 UniTask 只能 await 一次。它是结构体,内部对象完成后会被回收复用,再次 await 会出错。确实需要多次 await 时,调用 .Preserve()。
  • Forget() 的任务中出现的异常,会通过 UniTaskScheduler.UnobservedTaskException 输出到日志,不会被悄悄吞掉。
  • 编辑器中有 UniTask Tracker 窗口,可以查看当前所有正在运行的 UniTask,方便排查没有结束的任务(泄漏)。
  • 很多第三方库(DOTween、Addressables、YooAsset 等)都有 UniTask 的扩展,可以直接 await。

五、Awaitable(Unity 官方)#

Unity 2023.1 起(包括 Unity 6)内置了 Awaitable 类型,思路和 UniTask 类似:

async Awaitable Start()
{
await Awaitable.WaitForSecondsAsync(1f);
await Awaitable.NextFrameAsync();
await Awaitable.EndOfFrameAsync();
await Awaitable.FixedUpdateAsync();
await Awaitable.BackgroundThreadAsync(); // 切到后台线程
HeavyCompute();
await Awaitable.MainThreadAsync(); // 切回主线程
}
  • 内部对象使用对象池,GC 很少;同样只能 await 一次。
  • 配合 MonoBehaviour 的 destroyCancellationToken(Unity 2022.2 起)实现销毁时取消。
  • 优点:官方内置,不需要引入第三方库。
  • 不足:功能比 UniTask 少(比如组合多个任务的工具、调试窗口等),并且只能在较新的 Unity 版本中使用。

六、统一的取消方式:CancellationToken#

不管用哪种基于 async 的方案,取消都通过 CancellationToken 实现:

CancellationTokenSource _cts;
void StartCountdown()
{
_cts?.Cancel(); // 取消上一次
_cts = new CancellationTokenSource();
CountdownAsync(_cts.Token).Forget();
}
async UniTaskVoid CountdownAsync(CancellationToken token)
{
for (int i = 10; i > 0; i--)
{
label.text = i.ToString();
await UniTask.Delay(1000, cancellationToken: token);
}
}
void OnDisable() => _cts?.Cancel(); // 界面关闭时取消
  • 需要多个取消条件时(比如界面关闭或者物体销毁),用 CancellationTokenSource.CreateLinkedTokenSource 合并。
  • 被取消时抛出的 OperationCanceledException 是正常的控制流,不是错误,日志中不需要当错误处理。UniTask 也提供了 SuppressCancellationThrow(),可以把取消转换成返回值来判断。
  • CancellationTokenSource 用完要 Dispose。

七、选型#

协程TaskUniTaskAwaitable
返回值不支持支持支持支持
try/catch受限支持支持支持
取消StopCoroutineCancellationTokenCancellationTokenCancellationToken
绑定对象生命周期自动(依附 MonoBehaviour)不绑定GetCancellationTokenOnDestroydestroyCancellationToken
GC每次启动有分配每个 Task 有分配基本零分配很少(对象池)
受 timeScale 影响可选不受可选可选
使用位置只能在 MonoBehaviour 中启动任何地方任何地方任何地方
并行组合不方便WhenAllWhenAll / WhenAny较少
需要引入无无第三方库Unity 2023.1+

建议:

  • 新项目:首选 UniTask。功能最全、性能最好、生态最完善。
  • 不想引入第三方库,且 Unity 版本够新:用 Awaitable。
  • 协程:简单的、和单个物体强绑定的表现逻辑(比如一段特效序列)仍然可以用。但复杂的业务流程(加载 → 请求 → 弹窗 → 等待点击)用 async 写更清晰。
  • 原生 Task:只用于和 .NET 类库交互,不用来写游戏流程。

八、异步与多线程的分工#

上面这些方案解决的都是”等待”的问题,默认都在主线程上运行,本身不提供并行计算。

需求方案注意
等待加载、网络、时间协程 / UniTask / Awaitable主线程,可以直接调用 Unity API
少量耗时计算(解析大文件、压缩)Task.Run、UniTask.SwitchToThreadPool、Awaitable.BackgroundThreadAsync在其他线程上不能调用大部分 Unity API,算完要切回主线程
大量数据的并行计算(大量单位寻路、物理、网格生成)Job System + Burst数据要用 NativeArray 等容器,编译器保证线程安全

协程和 async 的原理、“异步不等于多线程”的详细说明,见 C# 迭代器与 async/await 原理。

常见追问#

协程是多线程吗? 不是。协程运行在主线程上,由 Unity 每帧调用迭代器的 MoveNext 推进,本质是同一线程上的分时执行。

yield return null 和 WaitForEndOfFrame 有什么区别? null 在下一帧所有 Update 之后继续;WaitForEndOfFrame 在当前帧渲染完成之后继续,常用于截屏。

物体被 SetActive(false) 后协程会怎样? 协程停止,重新激活后也不会恢复。只禁用组件(enabled = false)不会停止协程。

为什么不推荐在 Unity 中直接使用 Task? 不受对象生命周期管理(销毁后还会继续执行)、退出 Play 模式后仍在运行、不受 timeScale 影响、每次都有 GC 分配。

UniTask 为什么性能好? UniTask 是结构体并配合对象池,基本零分配;它挂在 PlayerLoop 上运行,不依赖 SynchronizationContext,还能指定在哪个更新阶段继续。

物体销毁后,异步方法还在执行怎么办? 用 CancellationToken:UniTask 的 GetCancellationTokenOnDestroy(),或 MonoBehaviour 的 destroyCancellationToken,在等待时传入,物体销毁时自动取消。

协程和 async/await 怎么选? 简单的、和单个物体绑定的表现序列可以用协程;需要返回值、异常处理、取消、组合多个异步操作的业务流程用 async(UniTask 或 Awaitable)。

UniTask 能 await 两次吗? 不能,内部对象完成后会被复用。需要多次 await 时调用 Preserve()。

想在后台线程做计算怎么办? 少量计算用 Task.Run 或 UniTask 的 SwitchToThreadPool,算完切回主线程再调用 Unity API;大规模并行计算用 Job System + Burst。

文章分享

如果这篇文章对你有帮助,欢迎分享给更多人!

Unity 异步编程:协程、async/await、UniTask 与 Awaitable
https://xslab.cloud/posts/unity/async-programming/
作者
LuxFire
发布于
2026-10-12
许可协议
CC BY-NC-SA 4.0
相关文章 智能推荐
1
C# 迭代器与 async/await 原理:编译器生成的状态机
C#底层/关键字 yield return 和 async/await 编译后分别变成了什么;状态机如何保存局部变量、如何从中断处继续;awaiter 模式;async 状态机什么时候会分配堆内存;SynchronizationContext 决定 await 之后在哪个线程继续;以及"异步不等于多线程"。
2
Unity 生命周期与时间:脚本执行顺序、Update 系列与 Time
Unity底层/基础 MonoBehaviour 各个事件函数的执行顺序与调用条件;Awake、OnEnable、Start 的区别,多个对象之间的执行顺序;FixedUpdate、Update、LateUpdate 各自适合做什么;Destroy 的延迟、移动端前后台切换;deltaTime、fixedDeltaTime、timeScale 等时间相关的值,以及帧率无关的写法。
3
Unity 物理:Rigidbody、Collider、Trigger、射线检测与 CharacterController
Unity底层/基础 静态碰撞体、运动学刚体、动态刚体的区别与移动方式;碰撞与触发的区别,OnCollision 和 OnTrigger 的触发条件;碰撞矩阵;射线与形状检测;CharacterController 与 Rigidbody 角色的对比;高速物体穿透与连续碰撞检测;以及物理插值。
4
Unity 动画系统:Animator 状态机、混合树、Root Motion、动画事件与性能
Unity底层/基础 Animation 与 Animator 的区别;Animator Controller 的状态、过渡、参数、Has Exit Time、动画层与遮罩;混合树;Humanoid 与 Generic、动画重定向;Root Motion;动画事件与 StateMachineBehaviour;Override Controller;以及 Animator 的性能问题与优化方案。
5
Unity 相机与 Layer:投影方式、清除、渲染顺序、相机堆叠与 Layer/Tag/Sorting Layer
Unity底层/基础 相机的透视与正交投影、清除方式、Culling Mask、多相机的渲染顺序、URP 相机堆叠、Viewport Rect 与 RenderTexture 的用途、屏幕与世界坐标转换;Layer、Tag、Sorting Layer 的区别与用途,LayerMask 的位运算,以及半透明物体的排序规则。
随机文章 随机推荐
Profile Image of the Author
LuxFire
Hello, I'm LuxFire.
公告
欢迎来到我的博客!这是一则示例公告。
音乐
封面

音乐

暂未播放

0:00 0:00
暂无歌词
分类
标签
站点统计
文章
60
分类
6
标签
164
总字数
171,869
运行时长
0 天
最后活动
0 天前

文章目录