Partilhar via


Habilitar ou instalar analisadores .NET primários

Os analisadores da plataforma de compilador .NET (Roslyn) inspecionam seu código C# ou Visual Basic em busca de problemas de qualidade de código e estilo de código. Os analisadores .NET de primeira parte são agnósticos em relação à plataforma de destino. Ou seja, seu projeto não precisa ter como destino uma plataforma .NET específica. Os analisadores funcionam para projetos destinados a net5.0versõ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 a partir do 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 destinados ao .NET 5.0 ou posterior. Você pode habilitar a análise de código em projetos destinados 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 mudar para o SDK do .NET 5+ ou se preferir um modelo baseado em pacote NuGet, os analisadores também estarão disponíveis no Microsoft.CodeAnalysis.NetAnalyzerspacote NuGet no Visual Studio 2019 e no 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 novos analisadores assim que atualizar o SDK. No modelo NuGet, você precisa atualizar o pacote NuGet sempre que quiser as correções de bugs mais recentes. O pacote NuGet é atualizado com mais frequência.

Migrar para analisadores .NET

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