要点

State 持有视图状态，Binding 将读写通道传给子视图。状态保留依赖视图身份，重新创建普通 struct 值不必然重置托管状态。

一、View 协议再深入

public protocol View {
    associatedtype Body: View
    @ViewBuilder @MainActor var body: Self.Body { get }
}

三个事实决定你写 SwiftUI 的方式：

1. 常见自定义 View 使用 struct：每次 body 求值都可能产生新的视图值，SwiftUI 靠视图在层级中的位置身份做 diff。
2. body 必须是纯描述：不应有副作用，不能假设它只被调用一次。
3. 视图 = 函数：VStack { Text("a"); Text("b") } 本质是调用 VStack.init(@ViewBuilder content:) 闭包。@ViewBuilder 让多个子视图按顺序组装为元组视图。

视图身份（Identity）小知识

• 结构性身份：if/else 两个分支是不同视图；ForEach 用数据 id 维持身份
• 显式身份：.id(someValue) 强制重建；列表增删动画异常时常与身份有关，详见 01-swiftui-essentials.md

二、@State：视图私有状态

struct PlayPauseButton: View {
    @State private var isPlaying = false

    var body: some View {
        Button(isPlaying ? "暂停" : "播放") {
            isPlaying.toggle()
        }
    }
}

要点：

• @State 把属性升级为 SwiftUI 托管的持久存储：视图重建（body 重算）不会丢失它
• 建议声明 private：清楚表达状态由本视图管理，避免从外部依赖其存储细节
• 可保存值类型；现代 Observation 模型也可以由 @State 持有，观察机制与普通引用类型不同
• 只在当前视图及直接子视图内使用的 UI 状态（开关、选中的 tab、输入草稿）用它

三、@Binding：双向绑定

子视图需要”读 + 改”父视图的状态时，传入 @Binding：

struct FilterSwitch: View {
    @Binding var isOn: Bool          // 只持有引用，不拥有数据

    var body: some View {
        Toggle("仅看未完成", isOn: $isOn)
    }
}

struct TaskListView: View {
    @State private var onlyUndone = false    // 真正的数据在这里

    var body: some View {
        FilterSwitch(isOn: $onlyUndone)      // $ 前缀把 @State 投影为 Binding
    }
}

理解 $：对 @State/@Binding 属性加 $ 前缀，取出其投影包装（ProjectedValue），即 Binding<T>。传入 Binding 的视图能读写源头，数据所有权仍在父视图。

四、@Observable：现代数据模型（Observation 框架）

@State/@Binding 适合视图私有的简单状态。跨视图共享的领域模型从 iOS 17 起用 Observation 框架：

import Observation

@Observable
final class NoteStore {
    var notes: [Note] = []
    var filterText = ""

    var filteredNotes: [Note] {
        filterText.isEmpty
            ? notes
            : notes.filter { $0.title.localizedCaseInsensitiveContains(filterText) }
    }

    func add(_ title: String) {
        notes.append(Note(title: title))
    }
}

struct NoteListView: View {
    @State private var store = NoteStore()   // 引用类型模型也用 @State 持有

    var body: some View {
        List(store.filteredNotes) { note in
            Text(note.title)
        }
        .safeAreaInset(edge: .bottom) {
            AddNoteBar { store.add($0) }
        }
    }
}

Observation 为什么比旧方案好

• 属性级追踪：视图只重算它实际读取的属性变化，粒度比旧 ObservableObject（整对象通知）更细
• 无需协议样板：@Observable 宏自动生成追踪代码，不再需要 @Published 与 objectWillChange
• 普通 Swift：在非 UI 层（测试、命令行）也能用，不绑定 Combine

模型跨层级传递

深层子视图需要同一份 store 时，用环境注入而不是逐层传递：

// 根部注入
ContentView()
    .environment(store)

// 任意深度子视图读取
struct BadgeView: View {
    @Environment(NoteStore.self) private var store

    var body: some View {
        Text("共 (store.notes.count) 条")
    }
}

五、单向数据流

把上述组件串成架构图：

用户操作
   │（闭包 / Binding 写入）
   ▼
状态（@State 持有的 store）
   │（Observation 追踪变化）
   ▼
受影响视图重算 body → SwiftUI diff → 更新屏幕

原则：

1. 状态只有一份，放在双方共同的最近父视图，或 @Observable store
2. 数据向下流（props/环境），事件向上流（闭包/Binding）
3. 视图永不修改不属于自己的状态——想改，就发事件给拥有者

最佳实践

先确定状态由谁拥有、谁只负责观察。只在当前界面生效的选择值可由 State 保存；多个界面共享同一模型时，应传递同一实例或从共同环境取得，分别创建会得到两份状态。

State 的存储与视图身份关联，不等于所有模型都必须在应用根部创建。筛选结果等可由已有数据计算时，避免再维护一份需要手动同步的变量。用“详情修改后列表是否更新”和“界面身份改变后状态是否重置”检查所有权是否符合设计。

以“列表进入详情后编辑名称”为例，先决定返回列表是否立即看到修改：如果需要，详情应编辑同一个模型或绑定；如果需要“取消编辑”，详情保存草稿，点击保存再写回。两者对应不同产品语义，不能只按某个属性包装器“更先进”选择。

验收： 执行进入详情、修改、取消、再次进入、修改、保存、返回列表这一组操作，逐步写出预期名称。再重建视图身份，确认临时草稿是否按预期重置。持久化到磁盘是另一项要求：界面仍显示正确值不能证明应用重启后数据仍在。

常见问题

Q1: 改了 @Observable 模型的属性，视图没刷新？

检查该视图是否真的读取了那个属性（Observation 按读取追踪）。若通过环境获取，确认用了 @Environment(Model.self) 且根部已 .environment(model) 注入。

Q2: @State 的值在视图跳转回来后被重置了？

@State 生命周期与视图身份绑定：视图从层级移除（如被 NavigationStack 弹出）后状态销毁。需要存活的持久状态放 SwiftData 或外部 store。

Q3: 旧的 ObservableObject / @Published 还能用吗？

能用，但新代码首选 @Observable。迁移对照与 API 全表见 04-swiftui-state-api.md。

练习与实践

练习一：基础练习

• [ ] 实现 CounterView（@State）+ StepperView（@Binding 接收数值）组合
• [ ] 创建 @Observable 的 ThemeStore（深色开关），用 .environment 注入并在子视图读取切换背景色
• [ ] 给 TaskListView 加搜索框，验证 filterText 变化时列表即时过滤

相关文档

• SwiftUI 布局
• Swift 语法要点
• SwiftUI Navigation
• 第一个 SwiftUI 应用
• 并发与 async/await