用途:面向 .NET 的 System.Threading.Channels 深度指南,用于实现高性能、线程安全的生产者/消费者通信。
主要能力:Channel<T> 创建(有界与无界);背压策略与容量管理;BoundedChannelFullMode(Wait、DropOldest、DropNewest、DropWrite);.NET 7+ 的 itemDropped 回调;生产者模式(WriteAsync、TryWrite、多生产者、Complete/TryComplete);消费者模式(WaitToReadAsync+TryRead、ReadAsync、多消费者扇出);ChannelReader.ReadAllAsync 的 IAsyncEnumerable 集成与 LINQ 异步操作符;性能优化(SingleReader/SingleWriter 标志、TryWrite 快路径);取消与优雅关闭(drain 模式、宿主关闭超时)。
使用方式:通过 Channel.CreateBounded<T>(capacity) 或 Channel.CreateUnbounded<T>() 创建通道,分离 Writer 与 Reader 端点;生产端调用 WriteAsync/TryWrite,消费端用 WaitToReadAsync+TryRead 或 ReadAllAsync 消费;结束时调用 Complete()/TryComplete() 通知消费者。
适用场景:生产环境工作队列、遥测/日志管道、API 端点流式响应、多消费者并行处理。
限制:无界通道在持续生产压力下可能耗尽内存,生产环境应优先使用有界通道;SingleReader/SingleWriter 标志若被违反会导致数据损坏而非异常;忘记调用 Complete() 会使消费者无限等待;itemDropped 回调在写入线程同步执行,不应阻塞。托管服务生命周期与 BackgroundService 注册、async/await 基础与取消令牌传播不在本指南范围内。