SwiftUI报错：无法将ObservedObject.Wrapper转为Binding<UserData>

问题描述 #

开发SwiftUI多步骤注册流程时，尝试将ObservableObject类型的UserData实例以Binding形式传递给子视图（如EmailRegistrationStepView、PhoneNumberStepView），在RegistrationView中出现错误：

Cannot convert value of type 'ObservedObject.Wrapper' to expected argument type 'Binding'

子视图需要更新共享的UserData对象，已尝试标准SwiftUI实践（@ObservedObject加$前缀）、清理构建文件夹、重启Xcode 15.0.1，问题仍未解决。

相关代码：

RegistrationView代码 #

import SwiftUI

struct RegistrationView: View {
    enum RegistrationStep {
        case emailAndPassword
        case phoneNumber
        case verificationCode
        ...
    }

    @State private var registrationStep: RegistrationStep = .emailAndPassword
    @ObservedObject var userData: UserData

    var body: some View {
        VStack {
            switch registrationStep {
            case .emailAndPassword:
                EmailRegistrationStepView(nextStep: $registrationStep, userData: $userData)
            case .phoneNumber:
                PhoneNumberStepView(nextStep: $registrationStep, userData: $userData)
            case .verificationCode:
    ...

UserData数据模型代码 #

class UserData: ObservableObject {
    // Use @Published to automatically update views when these properties change.
    @Published var email: String = ""
    ...

解决方案 #

方案1：修正子视图的参数类型（最常见场景） #

核心问题大概率是子视图参数定义错误：子视图不需要接收Binding<UserData>，而是直接接收ObservableObject实例，通过@ObservedObject观察其变化，直接修改内部@Published属性即可自动同步到父视图。

修改子视图定义：

struct EmailRegistrationStepView: View {
    @Binding var nextStep: RegistrationView.RegistrationStep
    @ObservedObject var userData: UserData // 用@ObservedObject而非@Binding

    var body: some View {
        // 直接修改@Published属性，自动同步到父视图
        TextField("邮箱", text: $userData.email)
        // ...其他UI元素
    }
}

父视图传递时直接传实例：

EmailRegistrationStepView(nextStep: $registrationStep, userData: userData)

方案2：传递单个属性的Binding（轻量化场景） #

如果子视图仅需修改UserData中的某一个属性，可以直接传递该属性的Binding，避免传递整个对象：

子视图定义：

struct EmailRegistrationStepView: View {
    @Binding var nextStep: RegistrationView.RegistrationStep
    @Binding var email: String // 只接收需要修改的属性的Binding

    var body: some View {
        TextField("邮箱", text: $email)
        // ...
    }
}

父视图传递对应属性的Binding：

EmailRegistrationStepView(nextStep: $registrationStep, email: $userData.email)

方案3：手动创建整个UserData的Binding（特殊场景） #

如果确实需要替换整个UserData实例（非常见场景），可以手动创建Binding：

在RegistrationView中生成自定义Binding：

let userDataBinding = Binding(
    get: { userData },
    set: { userData = $0 }
)

传递给子视图：

EmailRegistrationStepView(nextStep: $registrationStep, userData: userDataBinding)

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