必须用 await foreach 消费 IAsyncEnumerable<T>，否则编译报错 CS4032；它是独立异步遍历协议，非语法糖，foreach 仅支持 IEnumerable<T>，而 IAsyncEnumerable<T> 实现 IAsyncEnumerator<T>。
必须用 await foreach 消费 IAsyncEnumerable<T>，否则编译直接报错 CS4032；它不是“加 await 的 foreach”，而是专为异步流设计的独立遍历协议。
为什么普通 foreach 会编译失败
当你拿到一个返回 IAsyncEnumerable<string> 的方法（比如 DbDataReader.AsAsyncEnumerable() 或 EF Core 6+ 的 AsAsyncEnumerable()），直接写 foreach (var x in GetLinesAsync(reader))，编译器立刻拒绝：
- 报错信息是
CS4032: The 'foreach' statement cannot operate on variables of type 'IAsyncEnumerable<T>' - 这不是语法糖缺失问题，而是类型系统硬性限制：
foreach只认IEnumerable<T>和IEnumerator<T>，而IAsyncEnumerable<T>实现的是完全不同的IAsyncEnumerator<T>协议 - 试图用
Task.Run(() => { foreach ... })包一层，只是把同步阻塞搬进线程池，既失去流式优势，又浪费线程资源
await foreach 的实际执行行为
它不是“并发拉取所有数据再循环”，也不是“一次性加载到内存”，而是逐项等待、逐项处理：
- 每次迭代前调用
IAsyncEnumerator<T>.MoveNextAsync()，这个方法本身可被CancellationToken取消 - 只有上一项的
MoveNextAsync()完成并返回true，才会进入循环体执行你的逻辑（例如Console.WriteLine(line)） - 这意味着：读大文件时内存恒定；查询数据库分页时，下一页请求只在上一页处理完后才发起；实时消息流中，不会预取未消费的消息
- 性能关键点：如果你的处理逻辑（如网络调用、IO 写入）本身耗时，整个流会被拖慢——这不是
await foreach的问题，而是你没做并发解耦
常见误用与替代方案辨析
别把 IAsyncEnumerable<T> 当作普通集合来“转换”或“并发跑”：
-
.ToListAsync()或.ToArrayAsync()会强制等待全部数据到达，丢失流式价值；GB 级日志或无限消息源会直接 OOM -
ForEachAsync扩展方法（如list.ForEachAsync(x => DoAsync(x))）只适用于已加载到内存的IEnumerable<T>，对IAsyncEnumerable<T>无意义 - 想并发处理每条数据？不能在
await foreach循环体内直接await Task.WhenAll(...)，因为那会攒一堆待完成任务，破坏流控；正确做法是用Channel<T>+Task.Run或TPL Dataflow构建生产者-消费者管道 - 错误示例：
await foreach (var item in source) { await ProcessAsync(item); }—— 这是串行；想并行请换架构，别硬改这行
取消与异常传播的真实表现
await foreach 天然支持取消和异常透传，但行为和直觉略有差异：
- 传入
CancellationToken需通过WithCancellation扩展方法：await foreach (var item in source.WithCancellation(token))；不传则无法响应取消 - 如果
MoveNextAsync()抛异常（如网络中断），循环立即终止，异常向上抛出；如果循环体内（Console.WriteLine那里）抛异常，当前项处理失败，但流本身可能继续——取决于底层实现是否重试 - 没有内置的“跳过失败项继续”的机制；要实现容错，得自己包一层 try/catch 在循环体内，且注意别吞掉本该中止流的致命异常（如
OperationCanceledException）
最易被忽略的是：流的生命周期由消费者控制。一旦 await foreach 退出（无论正常结束还是异常中断），底层资源（如 DbDataReader、StreamReader）是否释放，取决于 IAsyncEnumerable<T> 的具体实现是否实现了 IAsyncDisposable ——EF Core 6+ 是，但手写迭代器常遗漏这点。
