SwiftUI 视图重构规范指南

纯文档型 Skill，提供 SwiftUI 视图重构指南，聚焦 MV 模式、依赖注入和 Observation 最佳实践，来源为知名社区贡献者 @Dimillian。

基本信息

• 技能名称?Swiftui View Refactor
• 中文名称?SwiftUI 视图重构规范指南
• 作者?steipete
• 分类?专业技能
• 版本?1.0.0
• 标签?swiftui, mv-pattern, observation, refactoring, dependency-injection, ios-development, view-model, code-style, architecture

使用方法

使用说明
核心用途
该 Skill 是一套 SwiftUI 视图结构规范化指南，帮助开发者重构视图文件以实现一致的代码结构、安全的依赖注入和正确的 Observation 使用。
显著优点

1. 清晰的视图排序规范 ：明确定义了从 Environment、属性、init 到 body、辅助方法的标准顺序，提升代码可读性和团队协作效率。
2. MV 模式优先 ：倡导轻量级视图、业务逻辑下沉到模型/服务，通过 @State 、 @Environment 、 task / onChange 替代不必要的 ViewModel，减少架构复杂度。
3. 实用的拆分策略 ：提供从 computed view properties 到独立 View 类型的渐进式提取方案，兼顾代码简洁与可复用性。
4. 安全的 ViewModel 处理 ：明确反对 optional ViewModel 和 bootstrapIfNeeded 模式，要求在 init 中直接注入依赖并初始化非 optional @State ViewModel。
5. 正确的 Observation 使用 ：清晰指导 @Observable 引用类型应作为 @State 存储在根视图，避免冗余包装。
   潜在局限性
   适用范围有限 ：仅针对 SwiftUI 视图层重构，不涉及 Combine、UIKit 桥接或更复杂的架构模式（如 TCA、Clean Architecture）。
   主观性约束 ："屏幕长度"等拆分阈值、何时提取独立 View 类型的判断带有一定主观性，需要团队达成共识。
   未覆盖测试指南 ：未提及如何为遵循这些规范的视图编写单元测试或 UI 测试。
   适合人群
   希望统一团队 SwiftUI 代码风格的 iOS/macOS 开发团队
   正在从 MVC/MVP/MVVM 向 SwiftUI 原生模式迁移的开发者
   需要重构遗留 SwiftUI 代码库以适配 Observation 框架的项目
   常规风险
   该 Skill 为纯 Markdown 文档（T-MD 分类），无可执行代码、无网络调用、无敏感数据访问，风险极低。主要风险在于开发者误解或过度应用规范——例如在不必要时强行拆分视图导致过度工程，或错误地将本应在 ViewModel 中的复杂逻辑保留在 View 层。
   综合评估
   这是一份高质量、实用性强的 SwiftUI 架构指南，来自在 SwiftUI 社区有良好声誉的开发者 @Dimillian（Thomas Ricouard）。其倡导的 MV 优先、最小化 ViewModel、显式依赖注入等原则与 SwiftUI 的设计哲学高度契合，适合作为团队代码规范的基础参考。