启用或安装第一方 .NET 分析器

.NET Compiler Platform (Roslyn) 分析器会检查 C# 或 Visual Basic 代码的代码质量和代码样式问题。 第一方 .NET 分析器与目标平台无关。 即,项目不需要面向特定的 .NET 平台。 分析器适用于面向 net5.0 及早期 .NET 版本(如 netcoreappnetstandardnet472)的项目。

可以通过以下一种方式启用或安装第一方 .NET 分析器:

  • 从 .NET SDK 中启用:从 Visual Studio 2019 16.8 和 .NET 5.0 开始,这些分析器包含在 Visual Studio 随附的 .NET SDK中。 分析功能针对面向 .NET 5.0 或更高版本的项目默认启用。 可通过将 MSBUILD EnableNETAnalyzers 属性设置为 true,在面向 .NET 早期版本的项目上启用代码分析。 你也可通过将 EnableNETAnalyzers 设置为 false,对项目禁用代码分析。

  • 安装为 NuGet 包:如果不想迁移到 .NET 5+ SDK,或者更喜欢基于 NuGet 包的模型,则 Visual Studio 2019 上的 Microsoft.CodeAnalysis.NetAnalyzers NuGet 包中也提供了这些分析器。 对于按需版本更新,你可能更倾向于使用基于包的模型。 如果使用的是 Visual Studio 2017,请改为安装最新版 2.9.xMicrosoft.CodeAnalysis.FxCopAnalyzersNuGet 包

注意

建议从 .NET SDK 启用分析器,而不是安装 Microsoft.CodeAnalysis.NetAnalyzers NuGet 包(如果可能)。 从 .NET SDK 启用分析器可以确保在更新 SDK 后,立即自动获取分析器 bug 修复和新分析器。 在 NuGet 模型中,每次需要最新的 bug 修复时都需要更新 NuGet 包。 NuGet 包会更频繁地进行更新。

迁移到 .NET 分析器

如果使用的是旧版 FxCop 分析器或 FxCop 分析器,并希望使用 .NET 分析器,请按照以下文章中的说明操作: