SwiftFormat 0.55.2 修复了 organizeDeclarations 与 blankLinesAtStartOfScope 的冲突问题

SwiftFormat 是一个流行的 Swift 代码格式化工具，它可以帮助开发者保持代码风格的一致性。在最新版本 0.55.2 中，修复了一个关于 organizeDeclarations 和 blankLinesAtStartOfScope 规则冲突的重要问题。

问题背景

在 SwiftFormat 0.54.6 版本中，当同时启用 organizeDeclarations 和 blankLinesAtStartOfScope 规则时，会出现一个意外的格式化错误。具体表现为在以下简单的 Swift 结构体代码中：

struct S {
    private func f() {}
    func g() {}
}

SwiftFormat 会错误地报告 blankLinesAtStartOfScope 的问题，尽管代码中实际上并没有违反这条规则。

问题分析

这个问题源于两个格式化规则之间的交互冲突：

1. organizeDeclarations 规则负责重新组织类型声明中的成员，按照访问控制级别等进行排序
2. blankLinesAtStartOfScope 规则则确保作用域开始处有适当的空行

当这两个规则同时启用时，在某些情况下会导致格式化逻辑出现判断错误，错误地认为代码违反了空行规则。

解决方案

SwiftFormat 的维护者在 0.55.2 版本中修复了这个问题。修复后的版本能够正确处理这种简单的结构体声明，不再错误地报告 blankLinesAtStartOfScope 问题。

最佳实践

对于使用 SwiftFormat 的开发者，建议：

1. 及时升级到最新版本（0.55.2 或更高）
2. 如果同时使用 organizeDeclarations 和 blankLinesAtStartOfScope 规则，确保测试代码格式化结果
3. 对于简单的类型声明，如示例中的结构体，可以放心使用这些规则组合

总结

这个修复展示了 SwiftFormat 项目对代码质量的高度重视。即使是看似简单的格式化规则交互问题，也能得到及时的关注和修复。开发者可以继续信赖 SwiftFormat 来保持代码的整洁和一致性。

对于遇到类似问题的开发者，建议检查 SwiftFormat 版本，并考虑升级到最新版本来解决这类格式化规则冲突问题。