共用方式為


停用 .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 專案

  • 來源分析與舊版分析

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

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

Visual Studio 2022 17.0.4 版和更新版本會在 [ 程序代碼分析 ] 屬性頁面中提供兩個複選框,以控制分析器是否在建置時間和設計時間執行。 若要停用專案中的程式代碼分析,請遵循下列步驟:

  1. 以滑鼠右鍵按兩下 方案總管 中的項目節點,然後選取 [ 屬性]。

  2. 選取 Code Analysis

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

    顯示 [程序代碼分析屬性] 頁面的螢幕快照。

  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 專案

  • 來源分析與舊版分析

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

.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>