SwiftUI自定义Binding引发意外渲染的原因及方案咨询

问题现象 #

排查应用性能问题时发现：使用自定义Binding的子视图，会在父视图因无关状态更新而重渲染时同步重渲染，即便该Binding关联的状态并未发生变化。

示例代码如下：

struct Parent: View {
    @State var text = "text"
    @State var bool = false

    var body: some View {
        let _ = Self._printChanges()
        VStack {
            CustomBindingChild(value: Binding<String>(
                get: {
                    text
                },
                set: { newValue in
                    text = newValue
                }
            ))
            BindingChild(value: $text)
            Divider()
            Text("\(bool)")
            Button("Toggle bool") {
                bool.toggle()
            }
            Button("Change text") {
                text = text == "text" ? "text 2" : "text"
            }
        }
    }
}

struct CustomBindingChild: View {
    @Binding var value: String

    var body: some View {
        let _ = Self._printChanges()
        Text(value)
    }
}

struct BindingChild: View {
    @Binding var value: String

    var body: some View {
        let _ = Self._printChanges()
        Text(value)
    }
}

测试现象：

• 点击「Change text」按钮时，三个视图都会打印重渲染日志，符合预期；
• 点击「Toggle bool」按钮时，父视图和CustomBindingChild都会打印日志，但预期只有父视图重渲染。

自定义StableBinding实现 #

为解决该问题，实现了自定义的StableBinding，通过遵守Equatable协议确保只有绑定值变化时才触发子视图重渲染：

@propertyWrapper
struct StableBinding<Value: Equatable>: Equatable {
    typealias Getter = () -> Value
    typealias Setter = (Value) -> Void

    private var getter: Getter
    private var setter: Setter

    var wrappedValue: Value {
        get { return getter() }
        nonmutating set { self.setter(newValue) }
    }

    var projectedValue: Self { self }

    init(get: @escaping Getter, set: @escaping Setter) {
        self.getter = get
        self.setter = set
    }

    init(_ binding: Binding<Value>) {
        self.getter = { binding.wrappedValue }
        self.setter = { newValue in
            binding.wrappedValue = newValue
        }
    }

    static func == (lhs: StableBinding<Value>, rhs: StableBinding<Value>) -> Bool {
        lhs.getter() == rhs.getter()
    }
}

技术疑问与解答 #

1. 为什么自定义Binding会导致意外重渲染？ #

SwiftUI判断子视图是否需要重渲染的核心逻辑是：比较子视图的输入参数是否发生变化，以及子视图依赖的状态是否更新。

• 对于系统自动生成的Binding（如$text），它本质是对原始@State的引用，属于稳定实例。SwiftUI内部能识别这种引用的一致性，不会因为父视图重传该Binding就判定参数变化。
• 而手动创建的Binding<String>(get:..., set:...)，每次父视图重渲染时都会生成全新的实例。由于Binding本身未实现Equatable协议，SwiftUI无法判断新旧Binding的行为是否一致，只能默认认为参数发生了变化，因此触发子视图重渲染。

2. 实现的StableBinding存在哪些潜在问题？ #

当前实现存在以下几个潜在风险：

• 值比较的局限性：==方法仅比较getter()的当前返回值，而非Binding的引用或行为一致性。如果两个不同的StableBinding当前值相同，但绑定的是不同状态，会被误判为相等，导致子视图错过必要的重渲染。
• Getter性能开销：每次SwiftUI检查重渲染条件时，都会调用getter()获取值进行比较。若getter包含复杂计算、IO操作等逻辑，会额外增加性能负担。
• 类型约束限制：要求Value必须遵守Equatable，无法用于非Equatable类型的数据，适用范围受限。
• 状态更新滞后：如果绑定的状态在两次重渲染检查之间发生变化，SwiftUI可能无法及时检测到，导致子视图显示旧数据。
• 原生兼容性问题：自定义属性包装器可能无法完全兼容SwiftUI的内部状态通知机制，极端场景下可能出现状态不同步的情况。

内容的提问来源于stack exchange，提问作者Gus Campos