SuperAPI AI 工具集

dotnet-editorconfig

通用与其它

查看项目

更新于 10-16 02:33

技能介绍

用途:指导在 .NET 项目中通过 .editorconfig 和全局 AnalyzerConfig(.globalconfig)配置 Roslyn 代码分析与代码风格规则。

主要能力:配置 IDE* 代码风格规则(命名、格式、表达式偏好)与 CA* 代码质量规则;设置 error、warning、suggestion、silent、none 五级严重级别;按规则或按类别批量设置严重级别;配置 AnalysisLevel 与 EnforceCodeStyleInBuild;定义命名规则(IDE1006);处理生成代码。

使用方式:在仓库根目录放置 .editorconfig 并设 root = true,用 glob 段(如 [*.cs])限定范围;用 dotnet_diagnostic.<规则ID>.severity 设置单条规则,用 dotnet_analyzer_diagnostic.category-<类别>.severity 设置整类规则。.globalconfig 需设 is_global = true,并通过 MSBuild 的 GlobalAnalyzerConfigFiles 引入。启用构建期风格检查需在 PropertyGroup 中设置 <EnforceCodeStyleInBuild>true</EnforceCodeStyleInBuild>。

优先级:单条规则 > 类别级 > global_level 更高的 .globalconfig > 更低的 .globalconfig > AnalysisLevel 默认值;目录层级中最近的 .editorconfig 覆盖上层。

适用场景:统一团队代码风格、在 CI 中强制规则、为测试项目放宽规则、为 NuGet 分析器包提供默认严重级别。

限制:不涉及添加分析器包、编写自定义 Roslyn 分析器或 Directory.Build.props 项目结构配置;IDE* 规则不参与类别级批量配置,需逐条设置;默认情况下 IDE* 规则仅在 IDE 中运行,需显式开启构建期检查。