如何在SwiftUI的@ViewBuilder静态函数中正确使用@State？

问题描述 #

我定义了一个Creatable协议，要求实现者必须包含一个创建视图的静态函数，该视图会创建对象并写入传入的Binding中：

protocol Creatable {
    associatedtype CreationView: View
    static func buildCreationView(toReplace: Binding<AnyMyObject>) -> CreationView
    // ...
}

实际场景中，用户选择协议实现类后，buildCreationView会生成对应对象的属性表单和创建按钮，点击按钮将新对象写入toReplace。

我尝试在@ViewBuilder修饰的静态buildCreationView函数中直接使用@State管理表单状态：

@ViewBuilder static func buildCreationView(toReplace: Binding<AnyMyObject>) -> some View {
    @State var fieldOne: String = ""
    
    Form {
        TextField("Field One", text: $fieldOne) // 此处报错
        Button {
            toReplace.wrappedValue = ObjectOne(fieldOne: fieldOne).erase
        } label: {
            Text("Create Object One")
        }
    }
}

这触发了SwiftUI运行时错误：“Accessing State's value outside of being installed on a View. This will result in a constant Binding of the initial value and will not update.”

我尝试用自定义Binding的方式临时解决，虽然可行但代码冗余：

var propertyOne: String = ""
let propertyOneBinding: Binding<String> = .init {
   propertyOne
} set: {
   propertyOne = $0
}

请问在@ViewBuilder视图构建函数中管理@State的正确方式是什么？

正确解决方案：用内部视图结构体托管@State #

@State必须声明在合法的SwiftUI View结构体的属性列表中，不能直接放在@ViewBuilder修饰的函数内部——因为函数内的@State无法被SwiftUI的视图生命周期系统识别和管理，这就是触发报错的核心原因。

正确的做法是为每个Creatable实现类创建对应的内部View结构体，把状态变量放在这个结构体里，再在buildCreationView中返回该结构体实例：

// 假设ObjectOne是Creatable协议的实现类
struct ObjectOne: Creatable {
    // 协议要求的关联类型，指定创建视图的类型
    typealias CreationView = ObjectOneCreationView
    
    static func buildCreationView(toReplace: Binding<AnyMyObject>) -> ObjectOneCreationView {
        ObjectOneCreationView(toReplace: toReplace)
    }
    
    // 内部视图结构体，专门处理创建表单的状态与UI
    private struct ObjectOneCreationView: View {
        let toReplace: Binding<AnyMyObject>
        // 这里的@State属于合法的View属性，会被SwiftUI正确管理
        @State private var fieldOne: String = ""
        
        var body: some View {
            Form {
                TextField("Field One", text: $fieldOne)
                Button {
                    toReplace.wrappedValue = ObjectOne(fieldOne: fieldOne).erase
                } label: {
                    Text("Create Object One")
                }
            }
        }
    }
}

方案优势 #

1. 内部的ObjectOneCreationView是标准SwiftUI View，@State作为它的属性会被SwiftUI绑定到视图生命周期，状态变化会自动触发视图更新。
2. 完全符合Creatable协议的要求：静态方法返回了协议规定的CreationView类型。
3. 相比自定义Binding的临时方案，这种写法贴合SwiftUI设计范式，避免了手动维护状态存储的冗余代码，可读性和可维护性更强。

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