代码分析规则具有多种配置选项。 可以在下列任一分析器配置文件中将这些选项指定为键值对：

提示

也可以在项目文件中设置代码分析配置属性。 这些属性在批量级别配置代码分析，完全将其打开或关闭到类别级别配置。 有关详细信息，请参阅 EnableNETAnalyzers、AnalysisLevel、AnalysisLevel 和 AnalysisMode。

EditorConfig 文件用于提供适用于特定资源文件或文件夹的选项。 选项位于节标头下，用于标识适用的文件和文件夹。 为要配置的每个规则添加一个条目，并将其放置在相应的文件扩展名节下，例如 [*.cs]。

在上面的示例中，[*.cs] 是一个 editorconfig 节标头，用于选择当前文件夹（包括子文件夹）中带有 .cs 文件扩展名的所有 C# 文件。 接下来 = 这一条目是一个分析器选项，将应用于所有 C# 文件。

可将文件放在相应的目录中，将 EditorConfig 文件约定应用于文件夹、项目或整个存储库。 可在生成时执行分析时以及在 Visual Studio 中编辑代码时应用这些选项。

注意

EditorConfig 选项仅应用于项目或目录中的源文件。 作为 AdditionalFiles 包含在项目中的文件不被视为源文件，EditorConfig 选项不会应用于这些文件。 若要将规则选项应用于非源文件，请在全局配置文件中指定该选项。

如果有一个现有的 .editorconfig 文件可用于编辑器设置（如缩进大小或是否剪裁尾随空格），可将代码分析配置选项放在同一文件中。

提示

Visual Studio 提供 .editorconfig 项模板，通过该模板可轻松地将其中一个文件添加到项目中。 有关详细信息，请参阅将 EditorConfig 文件添加到项目。

下面是一个示例 EditorConfig 文件，用于配置选项和规则严重性：

从 .NET 5 SDK（在 Visual Studio 2019 版本 16.8 和更高版本中受支持）开始，还可配置包含全局 AnalyzerConfig 文件的分析器选项。 这些文件用于提供适用于项目中所有源文件的选项，不考虑其文件名和文件路径。

与 EditorConfig 文件不同，全局配置文件不能用于为 IDE 配置编辑器样式设置，如缩进大小或是否剪裁尾随空格。 而是专用于指定项目级别分析器配置选项。

EditorConfig 文件必须包含节标头（如 [*.cs]），以标识适用的文件和文件夹，但全局 AnalyzerConfig 文件没有节标头。 相反，它们需要 is_global = true 格式的顶级条目，以便与常规 EditorConfig 文件区分开来。 这表示文件中的所有选项都适用于整个项目。 例如：

EditorConfig 文件必须命名为 .editorconfig，而全局配置文件不需要有特定的名称或文件扩展名。 但是，如果将这些文件命名为 .globalconfig，它们会隐式应用于当前文件夹（包括子文件夹）中的所有 C# 和 Visual Basic 项目。 否则，必须将 GlobalAnalyzerConfigFiles 项显式添加到 MSBuild 项目文件中：

考虑以下命名建议：

注意

将文件命名为 .globalconfig 时，不需要顶级条目 is_global = true，但为了清楚起见，建议使用它。

下面是一个示例全局 AnalyzerConfig 文件，用于在项目级别配置选项和规则严重性：

EditorConfig 文件和全局 AnalyzerConfig 文件都为每个选项指定键值对。 如果有多个条目具有相同键但值不同，则会发生冲突。 以下优先规则用于解决冲突。

严重性配置选项适用于下列其他优先规则：

在命令行上作为编译器选项（-nowarn 或 -warnaserror）指定的严重性选项始终会重写 EditorConfig 和全局 AnalyzerConfig 文件中指定的严重性配置选项。

规则集文件和 EditorConfig 或全局 AnalyzerConfig 文件中的严重性冲突条目的优先规则未定义。

规则集文件已弃用，改用 EditorConfig 和全局 AnalyzerConfig 文件。 建议将规则集文件转换为等效的 EditorConfig 文件。

有关具有不同键的相关严重性选项的优先级规则的信息（例如，为单个规则和为规则所属的类别指定不同的严重性），请参阅代码分析的配置选项。