SuperAPI AI 工具集

dotnet-editorconfig

编程与开发

查看项目

更新于 10-16 01:27

技能介绍

用途:指导在 .NET 项目中通过 .editorconfig 和全局 AnalyzerConfig 文件配置 Roslyn 代码分析与代码风格规则,包括 IDE* 风格规则、CA* 质量规则、严重级别、AnalysisLevel、EnforceCodeStyleInBuild、目录层级优先级及 .globalconfig。

主要能力:配置代码风格偏好(如 csharp_style_、dotnet_style_);用 dotnet_diagnostic.<规则>.severity 单独设置规则级别;用 dotnet_analyzer_diagnostic.category-{Category}.severity 批量设置类别级别;支持 error、warning、suggestion、silent、none 五级严重性;支持命名规则(IDE1006);支持 generated_code = true 抑制生成代码告警。

使用方式:在仓库根 .editorconfig 中设 root = true 阻止向上遍历;用 glob 段(如 [.cs])限定作用范围;就近文件优先。IDE 规则默认只在 IDE 运行,需在 MSBuild 属性中设 <EnforceCodeStyleInBuild>true</EnforceCodeStyleInBuild> 才能在 dotnet build 中生效,可配合 TreatWarningsAsErrors。.globalconfig 需 is_global = true,并通过 <GlobalAnalyzerConfigFiles Include="..." /> 引入,global_level 数值越大优先级越高。

适用场景:统一团队代码风格、在 CI 中强制代码分析、为测试项目放宽规则、为生成代码抑制告警、通过 NuGet 包分发默认规则配置。

限制:IDE* 规则不参与类别级批量配置,需逐条设置;.globalconfig 仅作用于分析规则,不提供格式化与重构支持;具体 AnalysisLevel 取值与 CA 规则完整列表需参考其他资料,本文未提供。