SwiftUI 模式

面向 Apple 平台的现代 SwiftUI 模式。用于构建声明式且高性能的用户界面。涵盖 Observation 框架、视图组合、类型安全的导航以及性能优化。

启动条件

• 构建 SwiftUI 视图并管理状态时（@State、@Observable、@Binding）
• 使用 NavigationStack 设计导航流程时
• 构建视图模型与数据流时
• 优化列表与复杂布局的渲染性能时
• 在 SwiftUI 中使用环境值与依赖注入时

状态管理

属性包装器的选择

选择最合适的、最简单的包装器：

包装器	使用场景
@State	视图本地的值类型（开关、表单字段、Sheet 显示）
@Binding	对父视图 @State 的双向引用
@Observable 类 + @State	拥有多个属性的所有权模型
@Observable 类（无包装器）	从父视图传入的只读引用
@Bindable	到 @Observable 属性的双向绑定
@Environment	通过 .environment() 注入的共享依赖项

@Observable ViewModel

使用 @Observable 而不是 ObservableObject——由于它在属性级别追踪变化，SwiftUI 仅重新渲染读取了已变更属性的视图：

@Observable
final class ItemListViewModel {
    private(set) var items: [Item] = []
    private(set) var isLoading = false
    var searchText = ""

    private let repository: any ItemRepository

    init(repository: any ItemRepository = DefaultItemRepository()) {
        self.repository = repository
    }

    func load() async {
        isLoading = true
        defer { isLoading = false }
        items = (try? await repository.fetchAll()) ?? []
    }
}

使用 ViewModel 的视图

s…