ConfigureAwaitOptions是.NET 5引入的枚举，用于精细控制await后的上下文恢复行为，包含None、ContinueOnCapturedContext和SuppressFlow等值，其中SuppressFlow推荐在.NET 6+中替代false以提升性能；实际开发中建议类库使用ConfigureAwait(ConfigureAwaitOptions.SuppressFlow)避免死锁，应用层根据是否需访问UI或HttpContext决定是否捕获上下文，ASP.NET Core因无SynchronizationContext默认无需处理，而WinForms/WPF应在更新UI时保留上下文；虽无全局开关，但可通过编码规范和Roslyn分析器统一异步策略。
ConfigureAwaitOptions 是 .NET 中用于控制 await 行为的枚举类型，它允许开发者更精细地管理异步操作完成后如何恢复执行上下文。这个特性从 .NET 5 开始引入，扩展了原有的 ConfigureAwait(bool) 方法的功能。
ConfigureAwaitOptions 枚举值说明
该枚举包含以下几个可选值：
-
None：等同于
ConfigureAwait(true)，表示恢复原始同步上下文（如 UI 线程）。 -
ContinueOnCapturedContext：明确启用上下文捕获，行为与
ConfigureAwait(true)相同。 - SuppressThrowing：这是关键新增选项，用于抑制因取消或异常导致的异常抛出行为（仅在特定高级场景下使用，不推荐常规使用）。
实际开发中最常见的用法是：
await task.ConfigureAwait(false); // 不恢复原始上下文，提升性能 await task.ConfigureAwait(true); // 恢复上下文，适用于需要访问 UI 或 ASP.NET HttpContext 的场景 await task.ConfigureAwait(ConfigureAwaitOptions.SuppressFlow); // .NET 6+ 推荐写法代替 false
如何配置整个应用的 await 默认行为？
.NET 并没有提供全局开关来统一改变所有 await 的行为（比如默认都 ConfigureAwait(false)），因为这可能带来不可预期的问题，尤其是上下文依赖的代码块。
但可以通过以下方式间接实现类似效果：
-
库项目中始终使用 ConfigureAwait(false)：如果你开发的是类库（特别是通用工具库），建议在内部所有
await后都加上.ConfigureAwait(false)，避免死锁并提升性能。 -
使用源生成器或分析器强制规范：可通过 Roslyn 分析器（如
Microsoft.VisualStudio.Threading.Analyzers）检测遗漏的ConfigureAwait调用，并在团队项目中强制编码规范。 -
ASP.NET Core 中默认无需特别处理：ASP.NET Core 的
SynchronizationContext是空的，因此即使不写ConfigureAwait(false)，也不会真正“捕获”上下文，性能影响较小。 -
WinForms/WPF 应用注意 UI 上下文：在需要更新 UI 的地方保留上下文（即不用
ConfigureAwait(false)），而在后台逻辑中尽量使用ConfigureAwait(false)避免调度开销。
最佳实践建议
- 在类库中，几乎所有内部
await都应使用ConfigureAwait(false)或ConfigureAwait(ConfigureAwaitOptions.SuppressFlow)。 - 在应用程序层（如 MVC 控制器、页面事件处理），可以根据是否需要访问 HttpContext 或 UI 元素决定是否捕获上下文。
- 不要试图通过反射或运行时手段修改整个应用的默认 await 行为，这会破坏框架设计原则。
基本上就这些。虽然不能一键配置全局 await 行为，但通过编码规范和工具约束，可以有效统一异步处理策略。
