# SwiftUI 模块化 MVVM-C 架构针对 SwiftUI 诊所风格应用程序的固执己见的架构实施。该技能与 iOS 26 / Swift 6.2 诊所架构保持一致：本地 SPM 包中的模块化 MVVM-C、App 目标中的具体协调器和路由 shell、纯域协议以及作为唯一 I/O 层的数据。 ## 强制架构堆栈 ┌──────────────────────────────────────────────────────────────┐ │ 应用程序目标：DependencyContainer、协调器、Route Shell │ ├────────────────┬────────────────┬──────────────────┬──────────────┤ │ 特色* SPM │ 特色* SPM │ 特色* SPM │ 特色* SPM │ │ 视图 + 虚拟机 │ 视图 + 虚拟机 │ 视图 + 虚拟机 │ 视图 + 虚拟机 │ ├────────────────────────────────────────────────────────────────┤ │ 数据 SPM：存储库实现、远程/本地、重试、同步队列 │ ├────────────────────────────────────────────────────────────────┤ │ 域SPM：模型、存储库协议、协调器协议│ │ 和错误路由/应用程序错误 │ ├────────────────────────────────────────────────────────────────┤ │ 共享 SPM：DesignSystem、SharedKit │ └────────────────────────────────────────────────────────────────┘ **依赖规则**：功能模块仅导入 `Domain` \+ `DesignSystem`。功能永远不会导入“数据”或其他功能。应用程序目标是唯一的汇聚点。 ## 诊所架构合约（iOS 26 / Swift 6.2）本技能中的所有指导均假定诊所模块化 MVVM-C 架构： * 功能模块仅导入 `Domain` \+ `DesignSystem` （从不导入 `Data`，从不导入同级功能） * App目标是汇聚点，拥有`DependencyContainer`、具体协调器和Route Shell接线 * `Domain` 保持纯粹的 Swift 风格，并定义模型以及存储库、`*Coordinating`、`ErrorRouting` 和 `AppError` 合约 * `Data` 拥有 SwiftData/network/sync/retry/background I/O 并实现域协议 * 读/写流默认为 stale-while-revalidate 读取和乐观排队写入 * ViewModel 直接调用存储库协议（无默认用例/交互器层） ## 何时申请在以下情况下请参考这些指南： * 在本地SPM包下构建或重构功能模块 * 连线协调器、路由 shell 和依赖容器工厂 * 定义存储库、协调器和错误路由的域协议 * 强制执行网络、持久性和同步的纯数据所有权 * 审查 stale-while-revalidate 读取和乐观排队写入 ## 不可协商的约束（iOS 26 / Swift 6.2） * ViewModels/协调器的`@Observable`，`ObservableObject`/`@Published`从不 * 没有专用的用例/交互器层：ViewModel 直接调用域存储库协议 * 协调器协议存在于域中；具体协调员在应用程序目标中拥有“NavigationPath” * 路由 shell 存在于 App 目标中并拥有自己的 .navigationDestination 映射 * `AppError` \+ `ErrorRouting` 驱动呈现策略； ViewModel 不会对全局错误 UI 进行硬编码 * SwiftData / URLSession / 重试 / 同步队列逻辑仅保留在 Data 包中 ## 按优先级规则类别优先|类别 |影响 |前缀|规则 ---|---|---|---|--- 1 |查看身份和差异 |关键 | `差异-` | 6 2 |国家建筑|关键 | `状态-` | 7 3 |查看作文 |高| `查看-` | 6 4 |导航与协调|高| `导航-` | 5 5 |层架构|高| `层-` | 6 6 |依赖注入 |中高| `迪-` | 4 7 |列表和收藏性能|中 | `列表-` | 4 8 |异步和数据流 |中 | `数据-` | 5 ## 快速参考 ### 1\.查看身份和差异（关键） * [`diff-equatable-views`]() \- 将 @Equatable 宏应用于每个 SwiftUI 视图 * [`diff-closure-skip`]() \- 使用@SkipEquatable作为闭包/处理程序属性 * [`diff-reference-types`]() \- 切勿存储不符合 Equatable 的引用类型 * [`diff-identity-stability`]() \- 在 ForEach 中使用稳定的 O(1) 标识符 * [`diff-avoid-anyview`]() \- 切勿使用 AnyView — 使用 @ViewBuilder 或泛型 * [`diff-printchanges-debug`]() \- 使用 _printChanges() 诊断不必要的重新渲染 ### 2\.状态架构（关键） * [`state-observable-class`]() \- 对所有 ViewModel 使用 @Observable 类 * [`state-ownership`]() \- @State 用于拥有的数据，用于注入数据的普通属性 * [`state-single-source`]() \- 每个状态的一个事实来源 * [`state-scoped-observation`]() \- 利用 @Observable 属性级跟踪 * [`state-binding-minimal`]() \- 仅对双向数据流传递 @Binding * [`state-environment-global`]() \- 使用 @Environment 进行应用程序范围的共享依赖项 * [`state-no-published`]() \- 切勿使用 @Published 或 ObservableObject ### 3\.查看构图（高） * [`view-body-complexity`]() \- 视图主体中最多 10 个节点 * [`view-extract-subviews`]() \- 将计算属性/帮助程序提取到单独的视图结构中 * [`view-no-logic-in-body`]() \- 正文中的零业务逻辑 * [`view-minimal-dependency`]() \- 仅传递所需的属性，而不是整个模型 * [`view-viewbuilder-composition`]() \- 使用 @ViewBuilder 进行条件组合 * [`view-no-init-sideeffects`]() \- 切勿在 View init 中执行工作 ### 4\.导航与协调（高） * [`nav-coordinator-pattern`]() \- 每个功能都有一个拥有 NavigationStack 的协调器 * [`nav-routes-enum`]() \- 将所有路由定义为可哈希枚举 * [`nav-deeplink-support`]() \- 协调器必须支持基于 URL 的深度链接 * [`nav-modal-sheets`]() \- 通过协调器呈现模态，而不是内联 * [`nav-no-navigationlink`]() \- 切勿使用 NavigationLink(destination:) — 使用 navigationDestination(for:) ### 5\.层架构（高） * [`layer-dependency-rule`]() \- 域层的框架导入为零 * [`layer-usecase-protocol`]() \- 不添加用例层；在 ViewModel + 存储库协议中保持编排 * [`layer-repository-protocol`]() \- 域中的存储库协议，数据中的实现 * [`layer-model-value-types`]() \- 域模型是结构，而不是类 * [`layer-no-view-repository`]() \- 视图从不直接访问存储库； ViewModel 调用存储库协议 * [`layer-viewmodel-boundary`]() \- ViewModel 仅公开显示就绪状态 ### 6\.依赖注入（中-高） * [`di-environment-injection`]() \- 通过 @Environment 注入容器管理的协议依赖项 * [`di-protocol-abstraction`]() \- 所有注入的依赖项都是协议类型 * [`di-container-composition`]() \- 在 App 目标中编写 `DependencyContainer` 并公开 VM 工厂 * [`di-mock-testing`]() \- 每个协议依赖项都有一个用于测试的模拟 ### 7\.列表和集合性能（中） * [`list-constant-viewcount`]() \- ForEach 必须为每个元素生成恒定的视图计数 * [`list-filter-in-model`]() \- ViewModel 中的过滤/排序，切勿在 ForEach 内 * [`list-lazy-stacks`]() \- 使用 LazyVStack/LazyHStack 获取无限内容 * [`list-id-keypath`]() \- 提供显式 id keyPath — 切勿依赖隐式身份 ### 8\.异步和数据流（中） * [`data-task-modifier`]() \- 使用 `.task(id:)` 作为主要功能数据加载触发器 * [`data-async-init`]() \- 切勿在 init 中执行异步工作 * [`data-error-loadable`]() \- 模型加载状态为枚举，而不是布尔值 * [`data-combine-avoid`]() \- 对于新代码，更喜欢 async/await 而不是合并 * [`data-cancellation`]() \- 使用 .task 自动取消 — 切勿手动管理任务 ## 如何使用阅读各个参考文件以获取详细说明和代码示例： * [章节定义]() \- 类别结构和影响级别 * [规则模板]() \- 用于添加新规则的模板 ## 参考文件文件|描述 ---|--- [references/_sections.md]() |类别定义和排序 [assets/templates/_template.md]() |新规则模板 [metadata.json]() |版本和参考信息

斯威夫特用户界面架构师

包含技能