讲师中心 微信公众号
AI工具推荐 视频效率加速

C# 异步方法状态机 C# async/await在底层是如何编译的

星敏小哥_9292

星敏小哥_9292

发布时间:2026-02-15 01:45:20

|

667人浏览过

|

来源于php中文网

原创

async方法被编译为实现IAsyncStateMachine的私有状态机类(或结构体),含局部变量、state字段及MoveNext方法;await不切换线程,而是通过OnCompleted注册MoveNext回调驱动状态恢复。

c# 异步方法状态机 c# async/await在底层是如何编译的

async 方法会被编译成状态机类

C# 编译器(Roslyn)遇到 async 方法时,不会生成普通方法体,而是重写为一个实现了 IAsyncStateMachine 接口的私有嵌套结构体(或类,取决于是否捕获局部变量),这个类型就是“状态机”。它包含所有局部变量、参数、await 点的暂存字段,以及 MoveNext() 方法——所有 await 逻辑都收束到这个方法里。

常见误区是以为 await 直接调用线程切换,其实它只是在状态机中记录当前执行位置(state 字段),然后返回一个未完成的 Task,后续靠 GetAwaiter().OnCompleted() 注册回调来驱动状态机继续执行。

  • 状态机字段名如 1__state、t__builder、<paramname>5__1</paramname> 都是编译器自动生成,不可见但可通过反编译(如 ILSpy)观察
  • 如果方法不包含 await,编译器仍会生成状态机,但会优化为同步完成(state = -2 表示已完成)
  • 捕获 this 或局部引用类型变量时,状态机会升格为 class(避免装箱/生命周期问题),值类型参数则按需拷贝

Builder 模式控制 Task 构建与完成

每个 async 方法开头都会初始化一个 AsyncTaskMethodBuilder<tresult></tresult>(或 AsyncVoidMethodBuilder),它封装了 Task 的创建、异常传播、同步/异步完成逻辑。真正的 Task 实例直到第一次 await 或方法退出才被真正构造或设置结果。

关键点在于:状态机不直接 new Task,而是通过 builder 的 SetResult()、SetException()、SetStateMachine() 等方法间接控制任务生命周期。

C#
C#

"避开 C# 常见错误——空陷阱、异步陷阱、LINQ 陷阱及资源泄漏。"

下载
  • SetStateMachine(this) 必须在 MoveNext() 首次调用前执行,否则 Task 无法正确绑定状态机
  • 对于 async void,使用 AsyncVoidMethodBuilder,异常会直接抛给同步上下文(SynchronizationContext),无法被外层 try/catch 捕获
  • builder 的 Task 属性在未完成前返回的是懒构造的占位符,不是真实运行时 Task

await 表达式展开为 GetAwaiter + OnCompleted + UnsafeOnCompleted

await 不是语法糖,而是一组确定的模式调用:编译器先调用表达式的 GetAwaiter(),再检查返回值是否实现 INotifyCompletion(常用 TaskAwaiter),然后插入 OnCompleted(action) 或更底层的 UnsafeOnCompleted(action) 注册回调。

这个回调函数正是状态机的 MoveNext(),它被包装进委托并传入。当 awaitable 完成时,该委托被调度执行,状态机从上次暂停的 state 值继续运行。

  • 如果 awaitable 已完成(IsCompleted == true),编译器可能跳过注册,直接同步执行后续代码(“快速路径”)
  • UnsafeOnCompleted 绕过栈探测和委托分配,在 hot path 上性能更高,但要求回调必须是无栈捕获的纯状态机调用
  • 自定义 awaitable 必须提供 GetAwaiter() + IsCompleted + OnCompleted() / UnsafeOnCompleted() + GetResult() 才能被 await 消费

调试时看到的“假堆栈”和状态机实例泄漏

在调试器中单步进入 async 方法,看到的堆栈常含 MoveNext 和大量 <xxx>d__N</xxx> 类型,这就是状态机实例。它生命周期往往长于方法调用本身——比如 await 一个网络请求时,状态机实例会一直存活,直到响应返回并执行完后续逻辑。

这意味着:状态机字段若持有大对象(如 byte[]、Stream),且未显式置空,就可能造成内存滞留;同时,调试器显示的“当前行”其实是状态机里的 goto 标签位置,不是原始源码顺序。

  • 反编译后可见 switch(state) 块,每个 case 对应一个 await 暂停点之后的恢复位置
  • 状态机实例默认不实现 IDisposable,无法用 using 释放,需靠 GC 回收;若需提前清理,应在 finally 块中手动清空大字段
  • 在高并发短生命周期场景(如 ASP.NET Core 中间件),过多状态机分配会影响 GC 压力,此时可考虑 ValueTask + 同步完成优化

热门AI工具

更多
Seko
Seko Hot

一款AI视频创作工具,主要用于商汤科技推出的创编一体的AI短视频创作Agent,适合需要提升相关任务效率的用户。

SkildArt
SkildArt Hot

SkildArt是一款AI文本写作工具,一站式 AI 视觉创作平台。

切问学术

切问学术是一款AI论文写作工具,复旦大学NLP团队推出的AI学术智能体。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

创客贴AI

创客贴AI是一款AI图像与设计工具,AI辅助的智能在线设计工具。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

咔片AIPPT

一款在线AI演示文稿制作工具,可根据主题和内容需求辅助生成PPT结构与页面,提高演示材料制作效率。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

超级简历WonderCV

一款AI办公效率工具,主要用于免费求职简历模版下载制作,应届生职场人必备简历制作神器,适合需要提升相关任务效率的用户。

相关专题

更多
什么是中间件
什么是中间件

中间件是一种软件组件,充当不兼容组件之间的桥梁,提供额外服务,例如集成异构系统、提供常用服务、提高应用程序性能,以及简化应用程序开发。想了解更多中间件的相关内容,可以阅读本专题下面的文章。

709

2024.05.11

Golang 中间件开发与微服务架构
Golang 中间件开发与微服务架构

本专题系统讲解 Golang 在微服务架构中的中间件开发,包括日志处理、限流与熔断、认证与授权、服务监控、API 网关设计等常见中间件功能的实现。通过实战项目,帮助开发者理解如何使用 Go 编写高效、可扩展的中间件组件,并在微服务环境中进行灵活部署与管理。

644

2025.12.18

ThinkPHP中间件机制与请求拦截处理实践
ThinkPHP中间件机制与请求拦截处理实践

本专题围绕 ThinkPHP 中间件体系展开,深入讲解中间件的定义、注册与执行流程。内容包括全局中间件与路由中间件的区别、请求前后处理逻辑、自定义中间件开发以及权限验证与日志处理应用。通过实际案例,帮助开发者掌握中间件在项目中的核心作用与最佳实践。

458

2026.03.31

switch语句用法
switch语句用法

switch语句用法:1、Switch语句只能用于整数类型,枚举类型和String类型,不能用于浮点数类型和布尔类型;2、每个case语句后面必须跟着一个break语句,以防止执行其他case的代码块,没有break语句,将会继续执行下一个case的代码块;3、可以在一个case语句中匹配多个值,使用逗号分隔;4、Switch语句中的default代码块是可选的等等。

1071

2023.09.21

Java switch的用法
Java switch的用法

Java中的switch语句用于根据不同的条件执行不同的代码块。想了解更多switch的相关内容,可以阅读本专题下面的文章。

1437

2024.03.13

go语言goto的用法
go语言goto的用法

本专题整合了go语言goto的用法,阅读专题下面的文章了解更多详细内容。

3137

2025.09.05

golang结构体相关大全
golang结构体相关大全

本专题整合了golang结构体相关大全,想了解更多内容,请阅读专题下面的文章。

5214

2025.06.09

golang结构体方法
golang结构体方法

本专题整合了golang结构体相关内容,请阅读专题下面的文章了解更多。

5391

2025.07.04

DBeaver怎么导入数据
DBeaver怎么导入数据

DBeaver数据导入专题,整理Excel、CSV、SQL、TXT等常见文件的数据导入方法,涵盖目标数据库选择、数据表创建、字段映射、数据类型设置及导入参数配置等操作,帮助用户将本地文件中的数据写入数据库,并了解批量导入、重复数据处理和导入失败等常见问题的解决方法。

20

2026.11.05

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn