Compartilhar via


Habilitar ou instalar analisadores .NET primários

Os analisadores da plataforma do compilador .NET (Roslyn) inspecionam seu código C# ou Visual Basic em busca de problemas de qualidade e estilo de código. Os analisadores .NET primários são independentes da plataforma de destino. Ou seja, seu projeto não precisa ser direcionado a uma plataforma .NET específica. Os analisadores funcionam para projetos direcionados net5.0a versões posteriores, bem como versões anteriores do .NET, como netcoreapp, netstandarde net472.

Você pode habilitar ou instalar os analisadores .NET primários de uma das seguintes maneiras:

  • Habilite no SDK do .NET: A partir do Visual Studio 2019 16.8 e do .NET 5.0, esses analisadores estão incluídos no SDK do .NET, que está incluído no Visual Studio. A análise é habilitada, por padrão, para projetos direcionados ao .NET 5.0 ou posterior. Você pode habilitar a análise de código em projetos direcionados a versões anteriores do .NET definindo a propriedade MSBUILD EnableNETAnalyzers como true. Você também pode desabilitar a análise de código para seu projeto definindo EnableNETAnalyzers como false.

  • Instalar como um pacote NuGet: Se você não quiser migrar para o SDK do .NET 5+ ou se preferir um modelo baseado em pacote NuGet, os analisadores também estarão disponíveis no pacote NuGet no Visual Studio 2019 e no Microsoft.CodeAnalysis.NetAnalyzers Visual Studio 2022. Você pode preferir um modelo baseado em pacote para atualizações de versão sob demanda. Se você estiver no Visual Studio 2017, instale a versão mais recente 2.9.x do Microsoft.CodeAnalysis.FxCopAnalyzerspacote NuGet .

Observação

É recomendável habilitar os analisadores do SDK do .NET em vez de instalar o Microsoft.CodeAnalysis.NetAnalyzerspacote NuGet, quando possível. Habilitar os analisadores do SDK do .NET garante que você obtenha automaticamente as correções de bugs do analisador e os novos analisadores assim que atualizar o SDK. No modelo NuGet, você precisa atualizar o pacote NuGet sempre que quiser as correções de bug mais recentes. O pacote NuGet é atualizado com mais frequência.

Migrar para analisadores do .NET

Se você estiver usando analisadores FxCop herdados ou analisadores FxCop e quiser usar os analisadores .NET, siga as instruções nos seguintes artigos: