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

  • 项目

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

可以通过以下一种方式启用或安装第一方 .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.NetAnalyzersNuGet 包中也提供了这些分析器。 对于按需版本更新，你可能更倾向于使用基于包的模型。 如果使用的是 Visual Studio 2017，请改为安装最新版 2.9.x 的 Microsoft.CodeAnalysis.FxCopAnalyzersNuGet 包。

注意

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

迁移到 .NET 分析器

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

相关内容