iOS 17中@Observable与TextField绑定异常问题求助

第一个错误：Cannot find '$model' in scope #

@Observable 宏生成的对象不能直接用 $ 前缀生成绑定，$ 是 SwiftUI 为 @State、@Binding 这类属性包装器预留的语法。要获取 @Observable 对象的属性绑定，必须用 @Bindable 修饰这个实例，才能通过 $ 访问绑定路径。

第二个问题：用 @Bindable 后 TextField 输入为空 #

大概率是这几个环节出了问题，逐个排查：

1. Exam 模型未用 @Observable 修饰 #

如果你的 Exam 是普通结构体：

struct Exam {
    var title: String
}

即使 GlobalViewModel 加了 @Observable，修改 exam.title 时，ViewModel 无法感知嵌套属性的变化，绑定自然无法同步。必须给 Exam 也加上 @Observable：

@Observable
class Exam {
    var title: String = ""
    
    init(title: String) {
        self.title = title
    }
}

如果 Exam 是结构体，用 @Observable 也可以，但结构体是值类型，修改时需注意替换整个实例，或依赖 @Observable 实现嵌套属性的可绑定能力。

2. 全局 ViewModel 的注入/初始化错误 #

如果 GlobalViewModel 不是单例，或环境注入方式不对，会导致 InfoView 拿到的实例和全局实例不一致，输入无法同步到全局数据。正确的全局注入方式如下：

• 定义 ViewModel：

@Observable
class GlobalViewModel {
    var exam: Exam
    
    init(exam: Exam) {
        self.exam = exam
    }
}

• 在 App 入口注入环境：

@main
struct YourApp: App {
    // 全局单例实例
    let globalVM = GlobalViewModel(exam: Exam(title: "初始标题"))
    
    var body: some Scene {
        WindowGroup {
            InfoView()
                .environment(globalVM) // 注入环境
        }
    }
}

• 在 InfoView 中正确获取并包装：

struct InfoView: View {
    @Bindable @Environment(GlobalViewModel.self) private var model
    
    var body: some View {
        CustomTextField(text: $model.exam.title)
    }
}

3. 自定义 TextField 实现错误 #

如果自定义 TextField 没有正确处理 Binding，比如只显示值但不更新绑定，就会出现输入为空的情况。正确的自定义实现应该是：

struct CustomTextField: View {
    @Binding var text: String
    var placeholder: String = ""
    
    var body: some View {
        TextField(placeholder, text: $text)
            .padding()
            .border(Color.gray)
    }
}

必须把内部 TextField 绑定到传入的 $text，不能自己定义 @State 变量，否则输入只会停留在组件内部，无法同步回外部绑定。

4. 误用值类型 Exam 导致绑定失效 #

如果 Exam 是结构体（值类型），修改 model.exam.title 会生成新的 Exam 实例，若 ViewModel 未正确替换原实例，绑定会失效。这种情况下，要么把 Exam 改成引用类型（class + @Observable），要么修改时替换整个 Exam：

// 结构体 Exam 的情况
@Observable
struct Exam {
    var title: String
}

// 修改时替换整个实例
model.exam = Exam(title: "新标题")

更推荐用引用类型的 Exam 配合 @Observable，这样嵌套属性的修改会自动触发 View 更新。

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