如何通过代码分析器强制特定C# if-else大括号格式化规则？

自定义Roslyn分析器与代码修复器 #

主流分析器库灵活性不足时，最精准的方案是自定义Roslyn分析器和代码修复器，完全匹配团队的规则：

• 针对if块：遍历语法树识别IfStatementSyntax，判断代码块是否跨多行（通过语法节点的行号范围判断），如果是多行则自动添加大括号；若已有大括号则保留。
• 针对else块：识别ElseClauseSyntax，判断其内部语句是否为单行表达式，若是则自动移除大括号；多行则保留大括号。
• 实现后打包成NuGet包分发到团队项目，IDE会自动检测并修复不符合规则的代码，从根源上统一格式。

配置IDE自定义格式化规则 #

不同IDE可通过精细化配置靠近需求，配合自定义分析器效果更好：

• Visual Studio：进入工具 -> 选项 -> 文本编辑器 -> C# -> 代码样式 -> 格式设置 -> 换行，调整if/else相关的换行规则；同时在代码样式 -> 常规中禁用与团队规则冲突的内置括号规则，避免自动格式化反向修改。
• Rider：进入设置 -> 编辑器 -> 代码样式 -> C# -> 大括号布局，选择「自定义」模式，针对if语句单独配置：设置if块多行时强制使用大括号，else块单行时不使用大括号。Rider的自定义配置支持更细粒度的条件判断，能覆盖大部分场景。

用.editorconfig统一基础规则 #

在代码库根目录添加.editorconfig文件，统一禁用主流分析器中冲突的规则（例如Roslynator的RCS1002、StyleCop的括号相关规则），同时启用自定义分析器的规则。将文件提交到仓库后，所有成员的IDE会自动加载配置，减少本地格式差异。

Git钩子自动前置修复 #

配置Git的pre-commit钩子，在代码提交前自动运行dotnet format（搭配自定义分析器），批量修复不符合风格的代码，避免无效改动流入PR。

内容的提问来源于stack exchange，提问作者Sergey Rybalkin