SwiftFormat项目中的多行语句大括号换行规则解析

在Swift代码格式化工具SwiftFormat中，有一个关于多行语句大括号换行的规则值得开发者注意。这个规则会影响guard和if等条件语句中大括号的换行行为。

现象描述

当使用guard语句时，如果条件部分跨越多行（通常是因为有多个条件），SwiftFormat默认会将左大括号{放在新的一行。例如：

guard boolCondition,
      anotherCondition else
{
    return nil
}

而当条件只有一行时，大括号则会保持在同一行：

guard boolCondition else {
    return nil
}

规则原理

这种行为是由SwiftFormat的wrapMultilineStatementBraces规则控制的。该规则专门针对多行语句的大括号换行进行格式化处理。它的设计初衷是为了提高多行条件语句的可读性，通过将大括号放在新行来更清晰地分隔条件和执行块。

如何禁用

如果开发者希望保持大括号始终在同一行，无论条件是否跨越多行，可以通过以下配置禁用该规则：

--disable wrapMultilineStatementBraces

禁用后，多行条件的guard语句也会保持大括号在同一行：

guard boolCondition,
      anotherCondition else {
    return nil
}

与其他规则的协同

值得注意的是，这个规则与--allman和--guardelse等规则是相互独立的。--allman规则控制的是所有大括号的换行风格，而wrapMultilineStatementBraces则专门针对多行语句的情况。--guardelse规则则只影响else关键字的位置。

最佳实践建议

对于团队项目，建议统一选择以下两种风格之一：

1. 启用wrapMultilineStatementBraces：保持多行条件语句的大括号换行，提高长条件语句的可读性
2. 禁用wrapMultilineStatementBraces：保持所有guard/if语句的大括号风格一致，无论条件是否跨行

选择哪种风格主要取决于团队对代码可读性和一致性的偏好。在条件较为复杂、跨越多行的情况下，第一种风格可能更有利于代码的清晰表达。