IAsyncEnumerable不能直接用foreach，因它是异步流，需用C# 8.0引入的await foreach语法调用GetAsyncEnumerator()和MoveNextAsync()；普通foreach仅支持同步IEnumerable。
为什么 IAsyncEnumerable 不能直接用 foreach 吃掉？
因为 IAsyncEnumerable 是异步流，普通 foreach 只支持同步枚举（IEnumerable）。直接写 foreach (var x in asyncSource) 会编译报错：error CS1937: The left-hand side of a 'foreach' statement must be of type 'IEnumerable' or 'IEnumerable。
必须用 await foreach —— 这是 C# 8.0 引入的专用语法，底层调用 GetAsyncEnumerator() 和 MoveNextAsync()。
-
await foreach是唯一安全、标准的消费方式；别试图转成List或ToArray()，那会阻塞整个流，失去异步意义 - 方法签名里返回
IAsyncEnumerable，意味着调用方**必须**用await foreach或手动处理IAsyncEnumerator - 如果在非 async 方法里想“强行同步等”，只能用
.ConfigureAwait(false).GetAwaiter().GetResult()，但极不推荐——容易死锁，且违背设计初衷
如何正确实现一个 IAsyncEnumerable 方法？
最常用、最直观的方式是用 yield return + async IAsyncEnumerable（C# 8+）：
async IAsyncEnumerable<string> ReadLinesAsync(string path)
{
await using var reader = new StreamReader(path);
string line;
while ((line = await reader.ReadLineAsync()) != null)
{
yield return line;
}
}</string>
注意几个硬性约束：
- 方法返回类型必须是
IAsyncEnumerable（不能是Task）> - 必须有
async修饰符，且方法体内至少有一个await或yield return -
yield return的值会在每次MoveNextAsync()被调用时异步产出，不是一次性全读进内存 - 别在
yield块里用try/catch捕获异常后吞掉——异常会延迟到消费者调用MoveNextAsync()时才抛出，调试时容易误判位置
IAsyncEnumerable 和 Task> 到底差在哪？
表面都是“未来会有一堆 T”，但语义和资源模型完全不同：
-
Task：先异步加载全部数据到内存（比如从 DB 拉一整张表），再返回一个已就绪的同步集合。内存峰值高，启动延迟大> -
IAsyncEnumerable：按需拉取、边产边送。比如分页查数据库，每次MoveNextAsync()触发一次SELECT ... LIMIT 1 OFFSET N，内存只存当前项 - 典型误用：
return await GetItemsAsync().ToListAsync();再包装成IAsyncEnumerable—— 完全没发挥流式优势，纯属套壳 - 性能关键点：数据库驱动、HTTP 客户端、文件读取器这些底层是否真正支持异步流（比如
SqlClient从 .NET Core 3.0 开始支持DbDataReader.GetFieldValueAsync，否则仍是同步阻塞）
常见报错和兼容性雷区
遇到 CS8411、CS4032 或运行时报 NotSupportedException，大概率踩了这些坑：
-
CS8411: Async foreach statement cannot be used with variables of type 'IAsyncEnumerable：目标框架太低，没引用' because 'IAsyncEnumerable ' does not contain a public instance or extension definition for 'GetAsyncEnumerator' System.Runtime.CompilerServices.Unsafe或未启用 C# 8+ 语言版本（检查项目文件8.0 - 在 .NET Standard 2.0 项目里直接用
IAsyncEnumerable：不行。它只在 .NET Core 3.0+ / .NET 5+ 原生支持；若必须跨平台，得通过 NuGet 引入Microsoft.Bcl.AsyncInterfaces包，并确保所有调用链都适配 - 用 EF Core 时写
context.Products.AsAsyncEnumerable()却没加await foreach：EF 会默默回退到同步枚举（触发警告 CA2007），并可能因连接未释放导致超时 - 自定义
IAsyncEnumerator实现忘了在DisposeAsync()里释放资源（如关闭HttpClient或DbConnection）：流中途被取消时资源泄漏风险极高
异步流真正的复杂点不在语法，而在于资源生命周期与取消信号的耦合——CancellationToken 要贯穿 MoveNextAsync、Current 获取、甚至 DisposeAsync 全过程，漏一处就可能卡住连接或线程。
