SwiftFormat 中 `spaceAroundBrackets` 规则对 `@Test` 包装器参数处理的修复

在 Swift 测试代码中，我们经常会使用 @Test 包装器来简化测试用例的编写。最近发现，在使用 SwiftFormat 格式化工具时，当 @Test 包装器的参数中包含类型转换操作（如 as [String]）时，spaceAroundBrackets 规则会产生不正确的格式化结果。

问题现象

考虑以下测试代码示例：

@Test(arguments: [kSecReturnRef, kSecReturnAttributes] as [String])
func foo(type: String) {
    print(type)
}

经过 SwiftFormat 格式化后，代码中的类型转换操作符 as 和方括号之间的空格被错误地移除了：

@Test(arguments: [kSecReturnRef, kSecReturnAttributes] as[String])
func foo(type: String) {
    print(type)
}

这种格式化结果在语法上虽然不会导致编译错误，但不符合 Swift 代码风格的最佳实践，因为类型转换操作符 as 后通常应该跟随一个空格。

技术背景

spaceAroundBrackets 是 SwiftFormat 中的一个规则，用于控制方括号周围的空格。它主要处理以下几种情况：

1. 数组字面量的方括号
2. 字典字面量的方括号
3. 下标访问的方括号
4. 泛型类型参数的方括号

在正常情况下，这个规则会确保方括号内部和外部有适当的空格。然而，在处理 @Test 包装器参数中的类型转换表达式时，规则出现了误判。

修复方案

SwiftFormat 的维护者在 0.54.4 版本中修复了这个问题。修复的核心思路是：

1. 识别 @Test 包装器参数中的类型转换表达式
2. 在处理 spaceAroundBrackets 规则时，跳过这些特殊场景
3. 保持类型转换操作符 as 后原有的空格

最佳实践建议

在编写包含类型转换的测试代码时，建议：

1. 保持 as 操作符后有一个空格
2. 对于复杂的测试参数，考虑使用类型明确的变量而非内联类型转换
3. 定期更新 SwiftFormat 工具以获取最新的修复和改进

总结

代码格式化工具虽然强大，但在处理一些特殊语法结构时可能会出现边缘情况。这次 SwiftFormat 对 @Test 包装器中类型转换表达式的处理修复，体现了开源社区对代码质量细节的关注。作为开发者，我们应当关注这类工具的更新，同时也要理解格式化规则背后的原理，以便在必要时能够调整配置或报告问题。