停用 .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 版與更高版本在 [程式碼分析] 屬性頁面提供兩個核取方塊,可供您控制分析器是否在組建階段及設計階段執行。 若要停用專案的程式碼分析,請遵循下列步驟:
在 [方案總管]中,以滑鼠右鍵按一下專案節點,然後選取 [屬性]。
選取 [程式碼分析]。
[程式碼分析] 屬性頁面隨即開啟。
若要在組建階段停用來源分析,請在 [在組建時執行] 下,清除 [一律在組建時執行程式碼分析]。
若要停用即時來源分析,請在 [在即時分析時執行] 下,清除 [於輸入時在編輯器中即時執行程式碼分析]。
注意
從 Visual Studio 2022 17.0.4 版開始,如果您想要隨選程式碼分析執行工作流程,您可以在即時分析期間停用分析器執行。 或者,可視需要針對專案或解決方案組建並手動觸發程式碼分析一次。 如需手動執行程式碼分析的詳細資訊,請參閱<手動執行 .NET 程式碼分析>。
.NET Framework 專案
若要關閉分析器的原始程式碼分析,請將下列一或多個 MSBuild 屬性新增至專案檔。
MSBuild 屬性 | 描述 | 預設 |
---|---|---|
RunAnalyzersDuringBuild |
控制分析器是否在建置階段執行。 | true |
RunAnalyzersDuringLiveAnalysis |
控制分析器是否在設計階段即時分析程式碼。 | true |
RunAnalyzers |
設定此屬性以便在組建及設計階段 false 停用分析器。 其優先順序高於 RunAnalyzersDuringBuild 與 RunAnalyzersDuringLiveAnalysis 。 |
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 停用分析器。 其優先順序高於 RunAnalyzersDuringBuild 與 RunAnalyzersDuringLiveAnalysis 。 |
true |
例如:
<RunAnalyzersDuringBuild>false</RunAnalyzersDuringBuild>
<RunAnalyzersDuringLiveAnalysis>false</RunAnalyzersDuringLiveAnalysis>
<RunAnalyzers>false</RunAnalyzers>