如何让C#编译器对非异步代码中未等待的Task发出警告

可以通过以下方式实现所需的警告提示：

启用代码分析规则CA2007 #

CA2007是专门检测未正确等待或处理Task对象的代码分析规则，它会扫描所有方法（包括非异步方法）中被丢弃的Task实例，一旦发现未等待、未存储也未传递的Task，就会生成警告。

启用方式：

• 在Visual Studio中，右键项目→属性→代码分析，勾选“启用代码分析”，在规则列表中找到CA2007，将其严重性设置为“警告”。
• 直接在项目文件（.csproj）中添加配置：

  <PropertyGroup>
    <AnalysisLevel>latest-recommended</AnalysisLevel>
    <WarningLevel>4</WarningLevel>
    <dotnet_diagnostic.CA2007.severity>warning</dotnet_diagnostic.CA2007.severity>
  </PropertyGroup>
  

• 或在.editorconfig文件中全局配置：

  dotnet_diagnostic.CA2007.severity = warning
  

临时快速检测技巧 #

如果只是临时排查代码问题，可以将目标非异步方法临时改为async void（仅用于检测，不要保留在生产代码中），此时编译器会触发CS4014警告，提示你哪些Task未被等待。检测完成后再改回原方法签名，逐一处理这些警告。

补充说明 #

C#编译器默认不在非异步方法中触发未等待Task的警告，是因为非异步场景下存在合法的“返回Task而不等待”的情况（比如实现异步接口的同步包装方法）。而代码分析规则CA2007会更细致地判断Task是否被合理处理，更适合捕捉未观察异常这类问题。

内容的提问来源于stack exchange，提问作者trampster