用途:以现代 MV(Model-View)架构构建和审查 SwiftUI 视图,覆盖架构、状态管理、视图组合、环境装配、异步数据加载与设计规范,用于重构既有视图和代码评审。
主要能力:默认采用 MV 模式,视图只做轻量状态表达,模型与服务承载业务逻辑,已有 view model 才沿用;状态归属区分 @State(视图拥有对象)、let(只读接收 @Observable)、@Bindable(双向绑定)、@Environment(Type.self)(共享对象);面向 UI 的 @Observable store 需标注 @MainActor;支持 @Entry 自定义环境值、.task 与 .task(id:) 异步加载;提供性能指引(LazyVStack/LazyHStack、稳定 Identifiable ID、避免 body 内计算)、HIG 对齐(语义色、系统字体、ContentUnavailableView、省略 stack 的 spacing)、iOS 18+ 写作工具行为控制,以及常见错误与审查清单。
使用方式:按“记录现有状态归属与副作用→做最小改动→每步构建验证→渲染 loaded/loading/empty/error 确定性预览→验证交互”的流程操作;重构时加载 Behavior-Preserving View Refactoring,预览夹具和依赖加载 Isolated Preview Construction。
限制:导航细节见 swiftui-navigation,布局与组件见 swiftui-layout-components,动画见 swiftui-animation,Liquid Glass 见 swiftui-liquid-glass。模式一般向后兼容 iOS 17,iOS 26 部分 API 需就近做可用性检查;.copyable、.cuttable 与命令式 .pasteDestination(for:action:validator:) 依当前 Apple 文档为 macOS 13+ 及 iOS/iPadOS/Mac Catalyst 27 beta,iOS 26 目标应改用 UIPasteboard、拖放或 ShareLink;具体价格与授权信息暂未提供。