每个代码分析规则都属于规则类别。 例如,设计规则支持遵守 .NET 设计准则,安全规则有助于防止安全漏洞。 可以为整个规则类别 配置严重性级别 。 还可以按类别 配置其他选项 。
下表显示了不同的代码分析规则类别,并提供指向每个类别中的规则的链接。 它还列出了在 EditorConfig 文件中要使用的配置值,以批量配置各类别的规则严重性。 例如,若要将安全规则冲突的严重性设置为错误,EditorConfig 条目为 dotnet_analyzer_diagnostic.category-Security.severity = error
。
小窍门
使用 dotnet_analyzer_diagnostic.category-<category>.severity
语法设置规则类别的严重性不适用于默认禁用的规则。 但是,从 .NET 6 开始,可以使用 AnalysisMode<Category> 项目属性启用类别中的所有规则。
设计规则
|
价值 |
规则链接 |
设计规则 |
说明 |
设计规则支持遵守 框架设计准则。 |
EditorConfig 值 |
dotnet_analyzer_diagnostic.category-Design.severity |
MSBuild 属性值 |
<AnalysisModeDesign> |
文档规则
|
价值 |
规则链接 |
文档规则 |
说明 |
文档规则支持通过正确使用 XML 文档注释为外部可见 API 编写有记录的库。 |
EditorConfig 值 |
dotnet_analyzer_diagnostic.category-Documentation.severity |
MSBuild 属性值 |
<AnalysisModeDocumentation> |
全球化规则
|
价值 |
规则链接 |
全球化规则 |
说明 |
全球化规则支持具备全球适用性的库和应用。 |
EditorConfig 值 |
dotnet_analyzer_diagnostic.category-Globalization.severity |
MSBuild 属性值 |
<AnalysisModeGlobalization> |
可移植性和互操作性规则
|
价值 |
规则链接 |
可移植性和互操作性规则 |
说明 |
可移植性规则支持跨不同平台的可移植性。 互作性规则支持与 COM 客户端的交互。 |
EditorConfig 值 |
dotnet_analyzer_diagnostic.category-Interoperability.severity |
MSBuild 属性值 |
<AnalysisModeInteroperability> |
可维护性规则
|
价值 |
规则链接 |
可维护性规则 |
说明 |
可维护性规则支持库和应用程序维护。 |
EditorConfig 值 |
dotnet_analyzer_diagnostic.category-Maintainability.severity |
MSBuild 属性值 |
<AnalysisModeMaintainability> |
命名规则
|
价值 |
规则链接 |
命名规则 |
说明 |
命名规则支持遵守 .NET 设计准则的命名约定。 |
EditorConfig 值 |
dotnet_analyzer_diagnostic.category-Naming.severity |
MSBuild 属性值 |
<AnalysisModeNaming> |
|
价值 |
规则链接 |
性能规则 |
说明 |
性能规则支持高性能库和应用程序。 |
EditorConfig 值 |
dotnet_analyzer_diagnostic.category-Performance.severity |
MSBuild 属性值 |
<AnalysisModePerformance> |
单文件规则
|
价值 |
规则链接 |
SingleFile 规则 |
说明 |
单一文件规则支持单一文件应用程序。 |
EditorConfig 值 |
dotnet_analyzer_diagnostic.category-SingleFile.severity |
MSBuild 属性值 |
<AnalysisModeSingleFile> |
可靠性规则
|
价值 |
规则链接 |
可靠性规则 |
说明 |
支持库和应用程序可靠性(例如正确使用内存和线程)的可靠性规则。 |
EditorConfig 值 |
dotnet_analyzer_diagnostic.category-Reliability.severity |
MSBuild 属性值 |
<AnalysisModeReliability> |
安全规则
|
价值 |
规则链接 |
安全规则 |
说明 |
安全规则支持更安全的库和应用程序。 这些规则有助于防止程序中出现安全漏洞。 |
EditorConfig 值 |
dotnet_analyzer_diagnostic.category-Security.severity |
MSBuild 属性值 |
<AnalysisModeSecurity> |
样式规则
|
价值 |
规则链接 |
样式规则 |
说明 |
样式规则支持代码库中的一致代码样式。 这些规则以“IDE”前缀开头。* |
EditorConfig 值 |
dotnet_analyzer_diagnostic.category-Style.severity |
MSBuild 属性值 |
<AnalysisModeStyle> |
* 使用 EditorConfig 值 dotnet_analyzer_diagnostic.category-CodeQuality.severity
启用以下规则: IDE0051、 IDE0052、 IDE0064 和 IDE0076。 虽然这些规则以“IDE”开头,但它们在技术上不是类别的 Style
一部分。
使用规则
|
价值 |
规则链接 |
用法规则 |
说明 |
使用规则支持 .NET 的正确用法。 |
EditorConfig 值 |
dotnet_analyzer_diagnostic.category-Usage.severity |
MSBuild 属性值 |
<AnalysisModeUsage> |