29 January 2026

MVVM Fundamentals

by Neoren

History及简介

职责：
- 负责 UI 展示 + 交互事件采集
- 只做轻量逻辑：布局、动画、简单的显示分支
- 不直接访问网络/数据库/缓存，不写业务规则
结构：
- 持有一个ViewModel实例（通过@Observable + @State/@Bindable）
- 用$将输入绑定到vm的状态
- 事件调用：vm.onAppear() (页面出现时加载数据), vm.refresh() (下拉刷新), vm.submit() (表单提交)
- 事件调用里的逻辑应该是业务编排

职责：
- 提供View可直接消费的状态
- 把用户意图转换成动作（对应View中的事件调用，比如：）
- 协调业务流程：（意图转换成动作时）调用 UseCase/Service/Repository (业务编排)，进行必要的数据转换、格式化、排序、过滤、权限判断等 (适配/派生)
- 管理异步：Task {}、async/await，以及错误处理、取消（可选）
结构：
- iOS 17+：@Observable class XxxViewModel { … }
- 将 UI 状态集中成一个类型更清晰：enum ViewState { case idle, loading, loaded([Item]), empty, failed(String) } 或 struct State { var items: [Item]; var isLoading: Bool; … }
- 依赖通过初始化注入（便于测试）：init(service: FooServiceProtocol)
- 经验法则：ViewModel 不持有 View（某属性不应指向一个View），也不返回 View（某方法不应返回一个View）；它只输出“可渲染的数据 + 可调用的动作”

领域模型(Domain Model / Entity)职责：
- 描述业务数据结构与规则（例如 User, Trip, Photo）
- 可包含纯业务计算（不依赖 UI/网络）
- 尽量保持与 UI 无关、与存储无关
数据来源与业务用例职责：
- Repository：屏蔽数据来源（网络/数据库/缓存），对上提供统一接口
- Service/API Client：封装网络请求细节
- UseCase（可选）：把“业务动作”封装成可复用单元
- 是否需要 UseCase 取决于项目规模：中大型项目更值得拆出来，小项目可以 VM 直接调用 Repository。
推荐链路：ViewModel → UseCase → Repository → Domain Model → ViewModel(转UI State)

PokedexUI implements a Protocol-Oriented MVVM architecture with Clean Architecture principles (不是严格的Clean架构，因为没有Domain层).
整洁架构的核心是：
- 把代码按职责分层
- 让依赖方向保持干净可控
- 协议隔离细节