为何SwiftUI中@Observable对象内无法绑定其结构体属性，外部却可？

问题核心 #

实现文本框防抖时，想把逻辑放在@Observable修饰的ViewModel中（而非视图层），但对嵌套结构体属性做防抖时遇到报错：Cannot find '$review' in scope；同时无法给review加@Published（提示Invalid redeclaration of synthesized property '_review'）。疑惑点在于：视图里能直接用$viewModel.review.body创建绑定，为什么ViewModel内部不行？

原因解析 #

1. $绑定语法是视图层专属：视图中的$viewModel.review.body是SwiftUI通过@Bindable生成的绑定语法糖，仅在View的body作用域内生效。ViewModel作为普通类，没有这个语法支持，无法直接通过$review.body获取变更流。
2. @Observable不自动处理嵌套结构体：@Observable只会给ViewModel自身的属性生成变更发布逻辑，不会递归给嵌套的结构体字段生成类似@Published的发布器，所以没法在ViewModel内部直接监听review.body的变化。

解决方案 #

方案1：手动监听结构体属性变化 #

通过didSet监听review的变更，筛选出body字段的变化，用PassthroughSubject构建事件流后做防抖：

import Combine
import SwiftUI

// 必须保留为struct的Review
struct Review: Codable {
    var rating: Int = 1
    var body: String = ""
}

@MainActor
@Observable
class TestViewModel {
    var review: Review = Review() {
        didSet {
            // 仅当body字段变化时发送事件
            if oldValue.body != review.body {
                bodyChangeSubject.send(review.body)
            }
        }
    }
    
    private let bodyChangeSubject = PassthroughSubject<String, Never>()
    private var cancellables = Set<AnyCancellable>()
    
    init() {
        bodyChangeSubject
            .debounce(for: .seconds(10), scheduler: RunLoop.main)
            .sink { [weak self] _ in
                guard self != nil else { return }
                print("It has been 10 seconds since this field was last edited")
            }
            .store(in: &cancellables)
    }
}

struct ContentView: View {
    @Bindable var viewModel: TestViewModel
    
    var body: some View {
        VStack {
            TextEditor(text: $viewModel.review.body)
                .background(Color.gray)
        }
        .padding()
    }
}

方案2：将字段移至ViewModel顶层 #

如果业务允许，直接把body作为ViewModel的顶层属性，简化监听逻辑：

import Combine
import SwiftUI

struct Review: Codable {
    var rating: Int = 1
}

@MainActor
@Observable
class TestViewModel {
    var review: Review = Review()
    var reviewBody: String = "" {
        didSet {
            bodyChangeSubject.send(reviewBody)
        }
    }
    
    private let bodyChangeSubject = PassthroughSubject<String, Never>()
    private var cancellables = Set<AnyCancellable>()
    
    init() {
        bodyChangeSubject
            .debounce(for: .seconds(10), scheduler: RunLoop.main)
            .sink { [weak self] _ in
                guard self != nil else { return }
                print("It has been 10 seconds since this field was last edited")
            }
            .store(in: &cancellables)
    }
}

struct ContentView: View {
    @Bindable var viewModel: TestViewModel
    
    var body: some View {
        VStack {
            TextEditor(text: $viewModel.reviewBody)
                .background(Color.gray)
        }
        .padding()
    }
}

关于绑定性能的疑问 #

视图中$viewModel.review.body的绑定依赖SwiftUI的精细化依赖追踪机制：它只会在review.body实际变化时触发视图更新，不会因为ViewModel其他属性变更而无效刷新，不用担心属性增多导致性能问题。

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