await foreach 仅支持 iasyncenumerable 类型，因其实质依赖 getasyncenumerator() 方法和 movenextasync() 状态机，同步集合如 list 或 ienumerable 因缺少该契约而编译失败，且需 c# 8+ 语言版本支持。
await foreach 只能用于 IAsyncEnumerable<t></t> 类型，不是所有“看起来能异步的东西”都支持它。直接对 List<t></t>、Array 或普通 IEnumerable<t></t> 写 await foreach 会编译失败——这不是语法糖，而是类型契约。
为什么 await foreach 编译不过？常见类型误用
错误常发生在把同步集合当成异步流处理，比如：
- 写
await foreach (var x in myList)（myList是List<int></int>）→ 报 CS1937：“The name 'x' does not exist in the current context”，本质是找不到GetAsyncEnumerator扩展方法 - 返回
IEnumerable<t></t>的方法被await foreach消费 → 编译器提示 “cannot convert from 'System.Collections.Generic.IEnumerable' to 'System.Collections.Generic.IAsyncEnumerable '” - 忘了在项目文件中启用 C# 8+：若
<langversion></langversion>小于 8，await foreach关键字不识别，连语法高亮都没有
如何正确生成 IAsyncEnumerable？yield return + async 缺一不可
必须同时满足两个条件：方法声明为 async IAsyncEnumerable<t></t>，且内部使用 yield return。缺任何一个都会退化为同步行为或编译报错。
-
async修饰符不能省：没有它，yield return无法挂起异步延迟（如await Task.Delay(100)） -
yield return不能换成return：那样就变成一次性返回整个集合，失去流式惰性特性 - 返回类型必须显式写成
IAsyncEnumerable<t></t>，不能只写async Task<ienumerable>></ienumerable>—— 后者仍是同步枚举，只是包了一层Task
正确示例：
async IAsyncEnumerable<string> ReadLinesAsync(string path)
{
await foreach (var line in File.ReadLinesAsync(path)) // 内置支持
yield return line.Trim();
}</string>
await foreach 中抛出异常时，资源会不会泄漏？
会，如果没正确释放 IAsyncEnumerator<t></t>。C# 编译器为 await foreach 生成的代码默认包含 try/finally 并调用 DisposeAsync()，但前提是枚举器实现了 IAsyncDisposable。多数内置实现（如 File.ReadLinesAsync）已实现，但自定义 IAsyncEnumerable<t></t> 若没手动实现 IAsyncDisposable，在中途 await foreach 被 break 或异常中断时，可能跳过清理逻辑。
- 自定义流中，应在
yield return前打开资源，在try/finally块里确保关闭（如stream.DisposeAsync()） - 不要依赖
using声明包裹await foreach：它只作用于枚举器本身，不自动传播到内部异步资源 - 若需强保证，显式获取枚举器并手动
await enumerator.DisposeAsync()
和 Parallel.ForEachAsync 性能怎么选？
await foreach 是顺序消费，Parallel.ForEachAsync 是并发消费——它们解决的问题根本不同，混用反而引入竞争或状态混乱。
- 用
await foreach：当数据源本身就是流式产生（如数据库游标、HTTP chunked 响应）、需要保序、或每个元素处理逻辑依赖前一个结果 - 用
Parallel.ForEachAsync：当你有一组已知全部加载完成的集合（如List<t></t>），且每个元素可独立异步处理（如批量发 HTTP 请求） - 别把
await foreach和Parallel.ForEachAsync套在一起：前者输出的是流，后者输入的是集合；强行转换要先ToListAsync()，就失去了流式内存优势
最易被忽略的一点：await foreach 的“异步”只发生在每次 MoveNextAsync()，不代表循环体内的操作自动并发——你在循环体内 await DoSomethingAsync(item)，仍是串行执行，除非你显式用 Task.WhenAll 批量触发。
