使用NSViewRepresentable封装NSTextField时触发StateObject访问错误

错误根源 #

这个错误核心是SwiftUI无法在View层级中正确追踪@StateObject的生命周期，导致绑定的数据源没有和View树建立有效关联，每次访问都会创建新的实例。通常出现在以下场景：

• 遍历数组时未正确创建元素属性的绑定
• NSViewRepresentable组件未正确处理绑定的更新逻辑
• 数据模型的属性未被正确标记为可观察

具体修复步骤 #

1. 确保数据模型的可观察性

如果MyObject是存储单条数据的模型，需要用@Published包装要绑定的属性，同时让MyObject遵循ObservableObject；顶层Model的数组属性也需用@Published标记，确保数组变化能被SwiftUI感知：

class MyObject: ObservableObject {
    @Published var property: String
    
    init(property: String) {
        self.property = property
    }
}

class Model: ObservableObject {
    @Published var objects: [MyObject] = []
}

2. 在LazyVGrid中正确传递绑定

遍历model.objects时，需通过索引创建绑定（直接传递元素属性绑定可能无法被SwiftUI正确追踪）：

struct ContentView: View {
    @StateObject private var model = Model()
    
    let columns = [GridItem(.flexible())]
    
    var body: some View {
        LazyVGrid(columns: columns) {
            ForEach(model.objects.indices, id: \.self) { index in
                MyTextField(text: $model.objects[index].property)
            }
        }
    }
}

3. 修正NSViewRepresentable的绑定处理

确保AppKitTextField的@Binding正确传递，且在updateNSView方法中同步NSTextField的值，同时通过Coordinator处理输入回调：

struct AppKitTextField: NSViewRepresentable {
    @Binding var text: String
    
    func makeNSView(context: Context) -> NSTextField {
        let textField = NSTextField()
        textField.delegate = context.coordinator
        textField.stringValue = text
        return textField
    }
    
    func updateNSView(_ nsView: NSTextField, context: Context) {
        // 仅当值不同时更新，避免循环触发
        if nsView.stringValue != text {
            nsView.stringValue = text
        }
    }
    
    func makeCoordinator() -> Coordinator {
        Coordinator(self)
    }
    
    class Coordinator: NSObject, NSTextFieldDelegate {
        var parent: AppKitTextField
        
        init(_ parent: AppKitTextField) {
            self.parent = parent
        }
        
        func controlTextDidChange(_ obj: Notification) {
            guard let textField = obj.object as? NSTextField else { return }
            parent.text = textField.stringValue
        }
    }
}

4. 简化中间组件的绑定传递

MyTextField作为中间组件，只需直接将绑定传递给AppKitTextField即可，无需额外处理：

struct MyTextField: View {
    @Binding var text: String
    
    var body: some View {
        AppKitTextField(text: $text)
            .frame(height: 30)
            .border(Color.gray)
    }
}

关键注意点 #

• 避免在makeNSView中直接访问@Binding的值，所有和绑定相关的更新逻辑都放在updateNSView中，因为makeNSView仅会调用一次，而updateNSView会在绑定值变化时触发。
• 若MyObject是值类型（struct），则无需让它遵循ObservableObject，但数组必须是@Published的，且遍历方式改为ForEach($model.objects) { $0.property }来传递绑定。

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