Task.FromResult 是用于将已知同步结果包装为已完成 Task 的零开销适配器，适用于缓存命中等无需等待的场景；不可用于伪装耗时同步操作为异步，应避免替代 Task.Run。
Task.FromResult 是什么，什么时候该用它
Task.FromResult 是一个静态方法，用来快速包装一个已知结果的值，生成一个已经完成（IsCompleted == true）的 Task 或 Task。它不启动新线程，也不调度异步操作，纯粹是“把同步结果转成 Task 形态”的零开销适配器。
典型使用场景是：你写的是异步接口（比如实现了 IAsyncEnumerable 的方法、或继承了某个要求返回 Task 的抽象类），但当前逻辑其实是同步的——比如缓存命中、配置读取、简单计算。这时不能直接 return 一个值，必须返回 Task；Task.FromResult 就是最轻量的解法。
别把它当成 Task.Run 的替代品
常见错误是用 Task.FromResult 包裹耗时同步代码，误以为“加了它就变异步了”。比如：
return Task.FromResult(CalculateHeavyResult()); // ❌ 仍是同步阻塞，只是包装成 Task
这会导致调用方 await 它时，线程被卡住，失去异步意义。真正要异步执行 CPU 密集任务，得用 Task.Run 或迁移到 ValueTask + 同步上下文处理。
-
Task.FromResult只适合结果**已经确定、无需等待**的场景 - 如果计算本身要花几十毫秒以上，优先考虑是否真需要异步签名，或改用
Task.Run - 在 ASP.NET Core 中滥用它可能掩盖同步阻塞问题，影响吞吐量
和 ValueTask 的关键区别在哪
从 .NET Core 2.0 起，ValueTask 成为更推荐的轻量替代方案，尤其对高频调用路径（如序列化、缓存访问）。它的优势是避免堆分配：Task.FromResult 每次都新建一个 Task 对象（引用类型），而 ValueTask 在结果已知时可直接用结构体承载。
示例对比：
// 返回 Task —— 每次都 new Task，GC 压力略高 public Task GetCachedValue() => Task.FromResult(42); // 推荐：返回 ValueTask —— 栈上分配，无 GC 开销 public ValueTask GetCachedValue() => new(42);
注意：ValueTask 不可重复 await，也不能直接用 await 后再传给其他 async 方法做组合（比如 WhenAll），这些地方仍得用 Task。
泛型参数 T 和 null 引用类型的兼容性
Task.FromResult 对 T 有隐式约束：当 T 是引用类型时，传入 null 是合法的；但若 T 是可空值类型（如 int?），也支持传 null。唯一要注意的是，不要误传 default(T) 给非空引用类型，否则可能掩盖业务逻辑错误。
- 对
string：可用Task.FromResult((string)null) - 对
int?：可用Task.FromResult(null) - 对
int：传null会编译失败，只能传具体数值或default(int)
如果你不确定上游是否可能为 null，又想保持返回类型干净，可以搭配 nullable reference types（#nullable enable）做编译期检查，比运行时抛 NullReferenceException 更早发现问题。
