0

0

C# ValueTask和Task区别 C#什么时候应该返回ValueTask

月夜之吻

月夜之吻

发布时间:2026-02-04 10:25:03

|

661人浏览过

|

来源于php中文网

原创

ValueTask 是 struct,避免堆分配,适用于高频调用且同步完成率高(如缓存命中)的场景;Task 是 class,适合常规异步操作。ValueTask 不可重复 await,不支持 .Result/.Wait(),误用反增开销。

c# valuetask和task区别 c#什么时候应该返回valuetask

ValueTask 和 Task 的本质区别

Task 是引用类型,每次异步操作都会在堆上分配一个对象;ValueTask 是结构体(struct),内部持有一个 Task 或直接保存结果值(如 int),避免不必要的堆分配。

关键不是“更快”,而是“在高频、短路径、同步完成率高”的场景下减少 GC 压力。如果方法大概率异步等待(比如真正要发 HTTP 请求、读磁盘),ValueTask 反而可能因装箱或额外判断开销略慢。

应该返回 ValueTask 的典型场景

满足以下全部条件时才考虑 ValueTask

  • 方法是 async 的,但存在较大概率(例如 >50%)同步完成(比如缓存命中、内存队列非空、状态已就绪)
  • 该方法被高频调用(如 ASP.NET Core 中间件、高性能网络库的读写入口)
  • 返回类型用于 await 表达式,且调用方不重复 await 同一个实例(ValueTask 不可重复 await,会抛 InvalidOperationException
  • 不需将返回值存储为字段、不传给其他方法作参数(除非转成 Task,如调用 .AsTask()

不该用 ValueTask 的常见错误

这些做法会抵消甚至逆转收益:

SeekAll
SeekAll

SeekAll是一款浏览器搜索聚合插件,支持在多个窗口中同时搜索。

下载
  • 对纯异步 I/O 方法(如 Stream.ReadAsync 底层必然调度)强行包装成 ValueTask —— 多余的 struct 开销 + 无实际堆节省
  • ValueTask 赋值给字段或属性(如 private ValueTask _init;),后续多次 await —— 第二次 await 就崩溃
  • 在泛型约束中要求 T : class 却返回 ValueTask,导致值类型实参编译失败
  • 调用方用了 .Result.Wait() —— ValueTask 不支持同步阻塞,会抛异常

如何安全地暴露 ValueTask API

如果你是库作者,对外提供 ValueTask 方法,务必在文档/注释里明确两点:

  • 该方法是否保证可 await 一次(是),以及同步完成的大致条件(如“当缓冲区有数据时同步返回”)
  • 若用户需要多次消费或跨 await 边界使用,请显式调用 .AsTask()
  • 避免在 public API 中返回 ValueTask —— 它没有明显优势,且容易让使用者误以为可重复 await

另外,.NET 6+ 的 IAsyncEnumerable 内部大量用 ValueTask,但那是运行时深度优化的结果,普通业务代码不必模仿。

最常被忽略的一点:ValueTask 的性能收益高度依赖 JIT 和运行时版本,.NET Core 3.0 之前它几乎没意义;现在也只在特定热点路径上有价值,别把它当成“Task 的升级版”来全局替换。

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

通义千问
通义千问

阿里巴巴推出的全能AI助手

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
什么是中间件
什么是中间件

中间件是一种软件组件,充当不兼容组件之间的桥梁,提供额外服务,例如集成异构系统、提供常用服务、提高应用程序性能,以及简化应用程序开发。想了解更多中间件的相关内容,可以阅读本专题下面的文章。

179

2024.05.11

Golang 中间件开发与微服务架构
Golang 中间件开发与微服务架构

本专题系统讲解 Golang 在微服务架构中的中间件开发,包括日志处理、限流与熔断、认证与授权、服务监控、API 网关设计等常见中间件功能的实现。通过实战项目,帮助开发者理解如何使用 Go 编写高效、可扩展的中间件组件,并在微服务环境中进行灵活部署与管理。

217

2025.12.18

golang结构体相关大全
golang结构体相关大全

本专题整合了golang结构体相关大全,想了解更多内容,请阅读专题下面的文章。

282

2025.06.09

golang结构体方法
golang结构体方法

本专题整合了golang结构体相关内容,请阅读专题下面的文章了解更多。

193

2025.07.04

string转int
string转int

在编程中,我们经常会遇到需要将字符串(str)转换为整数(int)的情况。这可能是因为我们需要对字符串进行数值计算,或者需要将用户输入的字符串转换为整数进行处理。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

563

2023.08.02

int占多少字节
int占多少字节

int占4个字节,意味着一个int变量可以存储范围在-2,147,483,648到2,147,483,647之间的整数值,在某些情况下也可能是2个字节或8个字节,int是一种常用的数据类型,用于表示整数,需要根据具体情况选择合适的数据类型,以确保程序的正确性和性能。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

547

2024.08.29

c++怎么把double转成int
c++怎么把double转成int

本专题整合了 c++ double相关教程,阅读专题下面的文章了解更多详细内容。

153

2025.08.29

C++中int的含义
C++中int的含义

本专题整合了C++中int相关内容,阅读专题下面的文章了解更多详细内容。

204

2025.08.29

全国统一发票查询平台入口合集
全国统一发票查询平台入口合集

本专题整合了全国统一发票查询入口地址合集,阅读专题下面的文章了解更多详细入口。

37

2026.02.03

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
10分钟--Midjourney创作自己的漫画
10分钟--Midjourney创作自己的漫画

共1课时 | 0.1万人学习

Midjourney 关键词系列整合
Midjourney 关键词系列整合

共13课时 | 0.9万人学习

AI绘画教程
AI绘画教程

共2课时 | 0.2万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号