在 C# 中配置錯誤和警告

理解警告和錯誤

在影片中，Derek介紹了將編譯器或Roslyn分析器警告報告為錯誤的概念。 他解釋說這是一個簡單的過程，可以幫助防止未來問題。 例如，當使用非同步方法時，忘記使用await關鍵字可能導致潛在的錯誤。 Derek示範了一個場景，他的方法SaveChangesAsync觸發了一個警告，因為它沒有使用await。 他強調了早期解決此類警告的重要性，以確保它們不會在將來變成更大的問題。

這種做法有助於提高程式碼質量、可維護性和整體系統穩定性。 無論是處理配置文件、異常處理還是系統設置，理解如何有效管理這些警告是建立有彈性應用程式的關鍵。

將警告轉換為錯誤

要將警告轉換為錯誤，Derek建議修改專案文件（.csproj）。 他展示了如何在專案文件的<WarningsAsErrors>元素。具體來說，對於警告CS4014（由於缺少await而生成的），新增此元素將警告轉換為錯誤，如果問題持續存在，則使構建失敗。 這種方法強制執行更嚴格的編碼標準，幫助在應用程式開發過程中及早發現潛在錯誤。

<PropertyGroup>
  <WarningsAsErrors>CS4014</WarningsAsErrors>
</PropertyGroup>

<PropertyGroup>
  <WarningsAsErrors>CS4014</WarningsAsErrors>
</PropertyGroup>

將概念應用於Roslyn分析器

Derek將此方法擴展到Roslyn分析器，這些分析器也會生成警告。 他使用Microsoft Visual Studio Threading Analyzer套件作為範例。

通過將此套件新增到專案並重新引入非同步問題，Derek強調了Roslyn分析器警告也可以轉換為錯誤。 這對依賴這些分析器來執行編碼標準和做法的團隊特別有用。 通過將這些警告作為錯誤對待，可以確保程式碼遵循框架定義的指南，並避免在生產中出現潛在問題。

<ItemGroup>
  <PackageReference Include="Microsoft.VisualStudio.Threading.Analyzers" Version="16.10.56" />
</ItemGroup>

<PropertyGroup>
  <WarningsAsErrors>VSTHRD103</WarningsAsErrors>
</PropertyGroup>

<ItemGroup>
  <PackageReference Include="Microsoft.VisualStudio.Threading.Analyzers" Version="16.10.56" />
</ItemGroup>

<PropertyGroup>
  <WarningsAsErrors>VSTHRD103</WarningsAsErrors>
</PropertyGroup>

忽略特定警告

在某些情況下，某些警告可能與您的專案無關。 Derek討論了如何使用專案文件中的<NoWarn>中忽略它。 此功能允許開發者根據他們的具體需求定制警告和錯誤報告系統，專注於對其專案最重要的問題，並忽略那些不相關的問題。

<PropertyGroup>
  <NoWarn>VSTHRD200</NoWarn>
</PropertyGroup>

<PropertyGroup>
  <NoWarn>VSTHRD200</NoWarn>
</PropertyGroup>

全解決方案配置

作為額外提示，Derek演示了如何使用Directory.Build.props文件將這些配置應用於整個解決方案。此方法確保設定在解決方案內的所有專案中保持一致，節省時間並保持一致性。 通過將配置放在此集中文件中，團隊可以在多個專案中執行相同的編碼標準價值觀和規則，確保所有程式碼庫都遵循相同的指南。 這對於擁有多個在開發中的大型團隊或組織特別有用。

<Project>
  <PropertyGroup>
    <WarningsAsErrors>CS4014;VSTHRD103</WarningsAsErrors>
    <NoWarn>VSTHRD200</NoWarn>
  </PropertyGroup>
</Project>

<Project>
  <PropertyGroup>
    <WarningsAsErrors>CS4014;VSTHRD103</WarningsAsErrors>
    <NoWarn>VSTHRD200</NoWarn>
  </PropertyGroup>
</Project>

結論

通過遵循Derek Comartin概述的各種配置步驟，您可以有效地管理C#專案中的編譯器和Roslyn分析器警告。 配置警告為錯誤可幫助保持高程式碼質量並防止潛在問題被忽視。 要獲得更詳細的演示，您可以觀看Derek的完整影片，標題為《Configuring Errors and Warnings in C#》，在他的CodeOpinion YouTube頻道上。