Swift 闭包：@escaping 与 @autoclosure

Swift 中的闭包是自包含的功能代码块，可以在代码中传递和使用。当你看到函数参数类型是 (Int, Int) -> Bool 这样的形式时，那其实就是一个闭包类型。但在实际开发中，你可能会遇到两种特殊的闭包修饰符：@escaping 和 @autoclosure。它们不是语法糖，而是编译器用来确保内存安全和简化调用的关键机制。

理解 @escaping：让闭包“逃出”函数作用域

默认情况下，Swift 假设闭包会在函数返回前被调用完毕。这意味着闭包的生命周期不会超过函数调用本身，因此编译器可以做更激进的优化。但如果你需要把闭包保存起来（比如存到属性里），或者在异步操作中稍后调用它，就必须显式标记为 @escaping。

添加 @escaping 修饰符到闭包参数类型前：

func fetchData(completion: @escaping (String) -> Void) {
    // 将闭包存储到实例变量，或在 DispatchQueue 中延迟调用
    DispatchQueue.global().async {
        let result = "数据加载完成"
        completion(result)
    }
}

如果不加 @escaping，上面的代码会报错：“Escaping closure captures non-escaping parameter 'completion'”。这是因为 DispatchQueue.global().async 会在未来某个时间点调用 completion，而那时 fetchData 函数早已返回。

调用带 @escaping 的函数时，闭包内部若引用了 self，必须显式写成 self. 或使用捕获列表：

class DataManager {
    var data: String = ""

    func load() {
        fetchData { [weak self] result in
            self?.data = result
        }
    }
}

这里 [weak self] 防止了循环引用——因为闭包被“逃逸”出去长期持有，如果直接强引用 self，会导致对象无法释放。

使用 @autoclosure：自动包装表达式为闭包

@autoclosure 的作用是让调用者无需写花括号 {}，直接传入一个表达式，编译器会自动把它包装成闭包。这常用于惰性求值场景，比如断言或条件执行。

定义一个接受 @autoclosure 参数的函数：

func logIfTrue(_ condition: @autoclosure () -> Bool, message: String) {
    if condition() {
        print(message)
    }
}

调用时直接传入布尔表达式，不用写闭包语法：

let x = 5
logIfTrue(x > 3, message: "x 大于 3") // 正常输出
logIfTrue(x > 10, message: "x 大于 10") // 不输出

注意：x > 3 这个表达式并没有立即求值，而是等到 condition() 被调用时才计算。这避免了不必要的开销，尤其当表达式涉及复杂运算时。

重要限制：@autoclosure 默认是非逃逸的（non-escaping）。如果你需要让它逃逸，必须同时写 @escaping @autoclosure：

var handlers: [() -> Void] = []

func addHandler(_ action: @escaping @autoclosure () -> Void) {
    handlers.append(action)
}

addHandler(print("Hello")) // 实际不会立即打印
// 只有当 handlers[0]() 被调用时才会执行

但这种组合很少见，且容易引发误解，通常应避免。

对比总结：何时用哪个？

常见错误与最佳实践

1. 不要滥用 @autoclosure
   它隐藏了闭包的执行时机，可能让调用者误以为表达式已立即求值。只在标准库风格的工具函数（如 assert、precondition）中使用。

2. @escaping 闭包中谨慎处理 self
   始终考虑是否需要用 [weak self] 避免循环引用。如果确定对象生命周期长于闭包，可用 [unowned self]，但风险更高。

3. 不要对同步立即执行的闭包加 @escaping
   这会让调用者困惑，并失去编译器对非逃逸闭包的优化机会。

4. @autoclosure 不能接收参数
   它只能包装无参表达式。如果你想传带参逻辑，必须用普通闭包。

通过正确使用 @escaping 和 @autoclosure，你能让 API 更安全、更简洁，同时避免内存泄漏和性能浪费。