停用 .NET 的原始程式碼分析

Visual Studio 可讓您控制原始程式碼分析器是否在組建時間及設計階段執行。 您可以停用的項目有一些限制,而且關閉程式碼分析的程式會根據幾個因素而有所不同:

  • 專案類型 (.NET Core、.NET Standard、.NET 5+ 與 .NET Framework)

    .NET Core、.NET Standard 與 .NET 5+ 專案在其 [程式碼分析] 屬性頁面提供選項,可讓您從安裝為 NuGet 套件的分析器關閉程式碼分析。 如需詳細資訊,請參閱<.NET Core、.NET Standard 與 .NET 5+ 專案>。 相較之下,.NET Framework 專案會要求在專案檔設定屬性。 若要關閉 .NET Framework 專案的原始程式碼分析,請參閱 .NET Framework 專案

  • 來源分析與舊版分析

    本文適用於原始程式碼分析,不適用於舊版 (二進位) 分析。 如需停用舊版分析的相關資訊,請參閱<啟用和停用受控程式碼的二進位程式碼分析>。

.NET Core、.NET Standard 與 .NET 5+ 專案

Visual Studio 2022 17.0.4 版與更高版本在 [程式碼分析] 屬性頁面提供兩個核取方塊,可供您控制分析器是否在組建階段及設計階段執行。 若要停用專案的程式碼分析,請遵循下列步驟:

  1. 在 [方案總管]中,以滑鼠右鍵按一下專案節點,然後選取 [屬性]。

  2. 選取 [程式碼分析]。

    [程式碼分析] 屬性頁面隨即開啟。

    螢幕擷取畫面顯示 [程式碼分析] 屬性頁面。

  3. 若要在組建階段停用來源分析,請在 [在組建時執行] 下,清除 [一律在組建時執行程式碼分析]。

  4. 若要停用即時來源分析,請在 [在即時分析時執行] 下,清除 [於輸入時在編輯器中即時執行程式碼分析]。

注意

從 Visual Studio 2022 17.0.4 版開始,如果您想要隨選程式碼分析執行工作流程,您可以在即時分析期間停用分析器執行。 或者,可視需要針對專案或解決方案組建並手動觸發程式碼分析一次。 如需手動執行程式碼分析的詳細資訊,請參閱<手動執行 .NET 程式碼分析>。

.NET Framework 專案

若要關閉分析器的原始程式碼分析,請將下列一或多個 MSBuild 屬性新增至專案檔

MSBuild 屬性 描述 預設
RunAnalyzersDuringBuild 控制分析器是否在建置階段執行。 true
RunAnalyzersDuringLiveAnalysis 控制分析器是否在設計階段即時分析程式碼。 true
RunAnalyzers 設定此屬性以便在組建及設計階段 false 停用分析器。 其優先順序高於 RunAnalyzersDuringBuildRunAnalyzersDuringLiveAnalysis true

例如:

<RunAnalyzersDuringBuild>false</RunAnalyzersDuringBuild>
<RunAnalyzersDuringLiveAnalysis>false</RunAnalyzersDuringLiveAnalysis>
<RunAnalyzers>false</RunAnalyzers>

此頁面可讓您在 Visual Studio 中停用程式碼分析。 您可以停用的項目有一些限制,而且關閉程式碼分析的程式會根據幾個因素而有所不同:

  • 專案類型 (.NET Core、.NET Standard、.NET 5+ 與 .NET Framework)

    .NET Core、.NET Standard 與 .NET 5+ 專案在其 [程式碼分析] 屬性頁面提供選項,可讓您從安裝為 NuGet 套件的分析器關閉程式碼分析。 如需詳細資訊,請參閱<.NET Core、.NET Standard 與 .NET 5+ 專案>。 如需有關如何關閉 .NET Framework 專案中原始程式碼分析的資訊,請參閱<.NET Framework 專案>。

  • 來源分析與舊版分析

    本文適用於原始程式碼分析,不適用於舊版 (二進位) 分析。 如需停用舊版分析的相關資訊,請參閱<啟用和停用受控程式碼的二進位程式碼分析>。

.NET Core、.NET Standard 與 .NET 5+ 專案

Visual Studio 2019 16.3 版與更高版本在 [程式碼分析] 屬性頁面提供兩個核取方塊,可供您控制分析器是否在組建階段與設計階段執行。 這些選項為專案專屬。

螢幕擷取畫面顯示 [程式碼分析] 屬性頁面。

若要開啟此頁面,請以滑鼠右鍵按一下 [方案總管] 的專案節點 ,然後選取 [屬性]。 選取 [程式碼分析] 索引標籤。

  • 若要在組建階段停用來源分析,請清除 [在組建時執行] 選項。
  • 若要停用即時來源分析,請清除 [在即時分析上執行] 選項。

注意

從 Visual Studio 2019 16.5 版開始,如果想要隨選程式碼分析執行工作流程,可以在即時分析期間停用分析器執行。 或者,可視需要針對專案或解決方案組建並手動觸發程式碼分析一次。 如需手動執行程式碼分析的詳細資訊,請參閱<手動執行 .NET 程式碼分析>。

.NET Framework 專案

若要關閉分析器的原始程式碼分析,請將下列一或多個 MSBuild 屬性新增至專案檔

MSBuild 屬性 描述 預設
RunAnalyzersDuringBuild 控制分析器是否在建置階段執行。 true
RunAnalyzersDuringLiveAnalysis 控制分析器是否在設計階段即時分析程式碼。 true
RunAnalyzers 設定此屬性以便在組建及設計階段 false 停用分析器。 其優先順序高於 RunAnalyzersDuringBuildRunAnalyzersDuringLiveAnalysis true

例如:

<RunAnalyzersDuringBuild>false</RunAnalyzersDuringBuild>
<RunAnalyzersDuringLiveAnalysis>false</RunAnalyzersDuringLiveAnalysis>
<RunAnalyzers>false</RunAnalyzers>