SwiftUI中@Observable对象无法绑定Picker的问题咨询

我是SwiftUI新手，希望视图中的Picker在用户交互时更新SettingsViewModel的currentSelection变量，但遇到问题：使用新的@Observable修饰ViewModel时，Picker的selection参数绑定$settingsViewModel.currentSelection会报错“cannot find '$settingsViewModel' in scope”；而使用旧的ObservableObject+@Published+@StateObject方式时，该绑定可正常工作。我好奇为何@Observable的表现与旧方式不同。

报错的@Observable版本代码 #

SettingsViewModel实现 #

import Foundation

@Observable
class SettingsViewModel {
    
    var currentSelection : ColorOptionEnum
    var dataHandler : DataHandler
    
    init() {
        let localdataHandler: DataHandler = .init()
        currentSelection = localdataHandler.currentBibleVersion
        dataHandler = localdataHandler
    }
}

SettingsView实现 #

import SwiftUI

struct SettingsView: View {
    var settingsViewModel : SettingsViewModel = .init()

    
    var body: some View {

        Form {
            Text("Mode")
            Picker(
                "Mode",
                selection: $settingsViewModel.currentSelection // 此处报错：cannot find '$settingsViewModel' in scope
            ) {
                Text("Green")
                    .tag(ColorOptionEnum.Green)
                Text("Blue")
                    .tag(ColorOptionEnum.Blue)
            }
            
        }
    }
}

#Preview {
    SettingsView()
}

可正常运行的ObservableObject版本代码 #

SettingsViewModel实现 #

import Foundation

class SettingsViewModel: ObservableObject {
    
    @Published var currentSelection : ColorOptionEnum
    var dataHandler : DataHandler
    
    init() {
        let localdataHandler: DataHandler = .init()
        currentSelection = localdataHandler.currentBibleVersion
        dataHandler = localdataHandler
    }
}

SettingsView实现 #

import SwiftUI

struct SettingsView: View {
    @StateObject var settingsViewModel : SettingsViewModel = .init()

    
    var body: some View {

        Form {
            Text("Mode")
            Picker(
                "Mode",
                selection: $settingsViewModel.currentSelection // 无报错
            ) {
                Text("Green")
                    .tag(ColorOptionEnum.Green)
                Text("Blue")
                    .tag(ColorOptionEnum.Blue)
            }
            
        }
    }
}

#Preview {
    SettingsView()
}

问题原因与解决方法 #

核心差异在于视图对ViewModel实例的生命周期管理和绑定生成逻辑：

• 旧的ObservableObject体系中，@StateObject是专门的视图状态包装器，它负责管理ViewModel的生命周期，并且自动支持通过$前缀生成绑定路径，因为@StateObject本身集成了可观察和绑定的能力。
• 新的@Observable类简化了ViewModel的定义，但视图中的ViewModel实例需要通过**@State或@Bindable包装**才能生成绑定：
  1. 如果ViewModel是当前视图内部创建的，用@State包装：

     struct SettingsView: View {
         @State var settingsViewModel : SettingsViewModel = .init()
         
         var body: some View {
             // Picker绑定$settingsViewModel.currentSelection可正常工作
         }
     }
     

  2. 如果ViewModel是从父视图传入的，用@Bindable包装：

     struct SettingsView: View {
         @Bindable var settingsViewModel : SettingsViewModel
         
         var body: some View {
             // Picker绑定$settingsViewModel.currentSelection可正常工作
         }
     }
     

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