核心用法
SwiftUI UI Patterns 是一套面向现代 Apple 生态的 UI 开发方法论，围绕 声明式语法、组件化组合、原生状态管理 三大支柱构建。文档提供两条清晰路径：
- 既有项目：通过
rg搜索定位相似代码，遵循本地约定（优先@State/@Observable、环境注入依赖），查阅references/components-index.md复用组件。 - 新项目脚手架：从
app-scaffolding-wiring.md入手，搭建TabView + NavigationStack + Sheets基础架构，定义AppTab与RouterPath路由枚举，按需扩展。
关键工作流强调：先定义状态归属，再梳理依赖注入，拆解视图层级，最后用 .task 实现异步加载与显式状态机。
显著优点
1. 官方对齐：深度整合 @Observable、Swift 结构化并发等 WWDC 新特性，避免过时的 MVVM 模板代码。
2. 实战导向：每个模式附带具体代码片段（如 item: 驱动的 Sheet、内部托管 dismiss() 的动作设计），可直接复制到 Xcode。
3. 可维护性：强制「小视图、纯组合」原则，配合本地索引文件（components-index.md）形成可检索的知识网络。
潜在局限
- 生态锁定：高度依赖 Apple 专有框架，跨平台（Android/桌面 Web）需完全重写。
- 版本敏感：
@Observable、NavigationStack 等 API 要求 iOS 16+，旧版本项目需维护兼容层。 - 隐式依赖：
@Environment注入在大型团队中易导致「魔法依赖」，需配合明确文档约定。
适合人群
- 使用 SwiftUI 2.0/3.0+ 的 iOS/macOS 开发者
- 正在从 UIKit 迁移或混合开发的团队
- 需要规范化组件库与路由架构的中大型项目
常规风险
| 风险点 | 缓解建议 |
|--------|----------|
| 滥用 `@StateObject` 导致内存泄漏 | 优先 `@State` + `@Observable`，明确生命周期 |
| Sheet 中 `if let` 引发状态不同步 | 严格使用 `item:` 重载，避免条件渲染 |
| 异步任务未取消造成竞态 | `.task` 自动绑定视图生命周期，复杂场景配 `TaskGroup` 取消令牌 |
| 路由枚举膨胀 | 按功能模块拆分 `RouterPath`，避免上帝枚举 |