ValueTask 是 C# 7.0 引入的轻量级 struct，用于优化高频率、大概率同步完成的异步操作，避免 Task 的堆分配开销；适用于缓存命中、中间件等场景，但不可重复 await 或直接用于 Task 组合。
ValueTask 是什么，什么时候该用它
ValueTask 是 C# 7.0 引入的轻量级结构体（struct），用来替代部分 Task 场景，避免不必要的堆分配。它内部可以包装一个 Task（异步未完成时）或直接保存同步结果（如 TResult 或 void）。本质是“可选堆分配”的异步操作容器。
适合用 ValueTask 的典型场景：
- 方法大概率同步完成（比如缓存命中、内存数据快速返回）
- 被高频调用（如 ASP.NET Core 中间件、序列化器、基础工具方法）
- 不需多次 await（ValueTask 不可重复 await，重复调用会抛异常）
- 不需作为 Task 对象传递给其他 API（比如不能传给
Task.WhenAll，得先.AsTask()）
怎么正确使用 ValueTask
声明和返回很简单，但要注意约束：
- 方法签名用
ValueTask<t></t>或ValueTask（对应 void） - 同步路径直接 return new ValueTask
(value)，不 new Task - 异步路径用
await普通 async 方法，编译器自动构造 ValueTask - 需要转成 Task 时调用
.AsTask()（仅在必须兼容 Task API 时才做）
示例：
public ValueTask<string> ReadAsync()
{
if (_cache != null) // 同步命中
return new ValueTask<string>(_cache);
<pre class='brush:php;toolbar:false;'>return ReadFromNetworkAsync(); // 真正 async 方法，返回 ValueTask<string>}
private async ValueTask
ValueTask 和 Task 性能差异在哪
核心区别在内存分配：
- Task 每次都分配在堆上（哪怕同步完成），GC 压力随调用频次上升
- ValueTask 同步路径零分配（纯栈/寄存器），异步路径仍分配一次 Task，但结构体本身仍为栈值
实际性能提升取决于使用模式：
- 100% 同步：ValueTask 几乎无开销，Task 多一次 GC 友好但可测的堆分配
- 50% 同步 + 50% 异步：ValueTask 平均减少约 30–50% 的短期对象分配
- 100% 异步：两者表现接近（都需 Task 分配），ValueTask 额外有 struct 拷贝成本，但通常可忽略
别只看微基准——高吞吐服务（如 JSON 序列化、路由匹配）中，把关键路径从 Task 改成 ValueTask，常能降低 Gen0 GC 次数 10%+。
不该用 ValueTask 的情况
滥用反而有害：
- 方法总是异步（比如固定要读文件、发 HTTP 请求）→ 用 Task 更清晰、更安全
- 需要多次 await 同一个对象 → ValueTask 不支持，会崩溃
- 要参与 Task 组合（
WhenAll、WhenAny、ContinueWith）→ 必须先.AsTask()，失去优势 - 公开 API 设计阶段不确定调用方用途 → 优先用 Task，保证兼容性和语义明确
一句话：ValueTask 是性能优化手段，不是 Task 的通用替代品。
基本上就这些。用对地方能省点分配，用错地方反而添麻烦。
