ValueTask 仅在异步操作同步完成时比 Task 快,因其避免堆分配;若总是异步完成,则无优势甚至略慢。

ValueTask 什么时候比 Task 快
ValueTaskValueTask 可以用栈上的结构体返回,而 Task 每次都 new 一个对象——这会触发 GC 压力。
常见同步完成场景包括:MemoryStream.ReadAsync(缓冲区有剩余)、ChannelReader.TryRead(队列非空)、自定义 IValueTaskSource 实现的即刻完成 awaitable。
- 如果方法 90% 以上走同步路径,
ValueTask能显著降低 Gen0 GC 次数 - 如果总是异步完成(比如真实网络 I/O),
ValueTask内部仍会创建Task,额外多一层封装开销(微乎其微,但不占优) - 没有 await 的情况下直接取
.Result或调用.GetAwaiter().GetResult(),ValueTask会 throwInvalidOperationException(已释放或未 await),而Task允许这样做(不推荐)
ValueTask 的复用限制和生命周期陷阱
ValueTask 是一次性值类型,设计上禁止重复 await 或多次消费。一旦 await 完成,内部持有的 IValueTaskSource 可能已被回收或重置;再次 await 会触发 ObjectDisposedException 或静默错误。
对比 Task:它是引用类型,可安全多次 await、存储到字段、传给多个消费者。
- ❌ 不要将
ValueTask存入类字段:private ValueTask_cache; - ❌ 不要两次 await 同一个变量:
var vt = GetDataAsync();
await vt;
await vt; // 可能崩溃 - ✅ 正确做法:立即 await,或转成
Task(调用.AsTask()),再做后续操作
Task 和 ValueTask 在泛型约束与接口实现上的差异
Task 实现了 INotifyCompletion 和 ICriticalNotifyCompletion,也实现了 IDisposable(空实现);ValueTask 同样实现这些接口,但它的 IDisposable 是为防止误用而设的——调用 Dispose() 仅在它包装的是 IValueTaskSource 且尚未完成时才有效。
本文档主要讲述的是Netty 代码分析;Netty提供异步的、事件驱动的网络应用程序框架和工具,用以快速开发高性能、高可靠性的网络服务器和客户端程序;有需要的朋友可以下载看看
关键约束差异:
-
ValueTask要求T必须是可默认构造的(where T : default隐含),因为内部结构体需支持无参初始化;Task无此限制 - 无法对
ValueTask使用await foreach(除非它包装的是IAsyncEnumerable);而Task可以> -
Task支持.ContinueWith()、.Wait()、.Result等同步阻塞 API;ValueTask不支持——必须先.AsTask()
应该选哪个:看调用方需求,不是看实现方性能
很多人误以为“高性能 API 就该返回 ValueTask”,其实选择依据是调用模式:
- 库作者提供底层 I/O 方法(如
Stream.ReadAsync)→ 返回ValueTask,因为使用者大概率 await 一次且重视分配 - 业务逻辑层组合多个 await → 返回
Task,避免把ValueTask传播出去导致调用方踩坑 - 需要缓存、重试、超时包装(如
Policy.WrapAsync(...).ExecuteAsync(...))→ 统一转.AsTask(),否则策略库无法安全持有 - 单元测试中 Mock 异步方法 →
Task更容易 fake(Task.FromResult),ValueTask需要构造ManualResetValueTaskSourceCore,麻烦得多
最常被忽略的一点:ValueTask 的性能收益只在高吞吐、低延迟、同步完成比例高的服务中可测;普通 Web API 或命令行工具几乎感知不到,反而因误用引入隐蔽异常。










