.NET 编译器平台 (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 包的模型,则分析器也可用于
Microsoft.CodeAnalysis.NetAnalyzers
Visual Studio 2019 和 Visual Studio 2022 上的 NuGet 包。 你可能更喜欢基于包的模型进行按需版本更新。 如果使用的是 Visual Studio 2017,请改为安装最新版本2.9.x
的Microsoft.CodeAnalysis.FxCopAnalyzers
NuGet 包 。
注释
建议从 .NET SDK 启用分析器,而不是尽可能安装 Microsoft.CodeAnalysis.NetAnalyzers
NuGet 包。 从 .NET SDK 启用分析器可以确保在更新 SDK 后,立即自动获取分析器 bug 修复和新分析器。 在 NuGet 模型中,每次需要最新的 bug 修复时,都需要更新 NuGet 包。 NuGet 包更新得更频繁。
迁移到 .NET 分析器
如果使用的是旧版 FxCop 分析器或 FxCop 分析器,并且想要使用 .NET 分析器,请按照以下文章中的说明作: