（3117期）FOSMVVM ViewModel Generator – SwiftUI MVVM代码生成与本地化自动化

SwiftUI MVVM代码生成与本地化自动化 为SwiftUI生成FOSMVVM架构的ViewModel代码，支持服务端/客户端双模式托管，自动处理本地化绑定与工厂生成，适用于页面、组件及错误展示场景。 使用说明 FOSMVVM ViewModel Generator 评估 核心用法 该技能用于生成遵循FOSMVVM架构模式的SwiftUI ViewModel代码，通过@ViewModel宏自动处理本地化字符串绑定、工厂方法生成等重复性工作。核心设计哲学是ViewModel作为数据与视图之间的桥梁——服务端或客户端工厂创建ViewModel，编码阶段完成本地化解析，视图仅负责渲染已本地化的数据。 双模式托管架构是最大特色： Server-Hosted模式：数据来自服务端数据库，需手写ViewModelFactory，服务端在JSON编码时完成本地化 Client-Hosted模式：数据为本地状态（如设置页、错误展示），使用@ViewModel(options: [.clientHostedFactory])，宏自动生成工厂 典型工作流程 确定托管模式：根据数据来源（服务端/本地）选择对应模式 区分ViewModel类型：Display ViewModel（只读展示）vs Form ViewModel（用户输入，需遵循Fields协议） 应用@ViewModel宏：自动生成propertyNames()方法以支持本地化绑定 配置本地化资源：YAML文件管理静态UI文本，动态枚举值使用存储型LocalizableString 代码生成能力 | 场景 | 生成文件 ||------|---------|| Server-Hosted顶层 | 4文件：ViewModel、Request、YAML、Factory || Client-Hosted顶层 | 2文件：ViewModel（含宏生成工厂）、YAML || 子ViewModel | 1-2文件：ViewModel、可选YAML | 显著优点 架构一致性强制：通过宏和协议层级（ViewModel → RequestableViewModel）确保项目遵循MVVM模式，避免视图层混入业务逻辑 本地化自动化：@LocalizedString、@LocalizedSubs、@LocalizedCompoundString等属性包装器配合YAML资源，实现编码期本地化，视图无需处理字符串查找 双模式灵活性：同一应用可混合使用两种模式（如服务端登录+本地设置），且RequestableViewModel与Client-Hosted ViewModel遵循相同渲染模式 类型安全错误处理：反对统一错误架构，鼓励为每种错误场景创建特定ViewModel（如MoveIdeaErrorViewModel），利用Swift类型系统精确匹配 测试友好：Stubbable协议要求所有ViewModel实现stub()，支持SwiftUI预览和单元测试；嵌套类型采用双层Stub模式（零参数委托参数化版本） Swift 6并发就绪：生成的代码默认标记Sendable，符合现代Swift并发要求 潜在缺点与局限性 学习曲线陡峭：需理解FOSMVVM完整架构（Factory、Request、Fields等协议体系），文档中提及的"错误是数据"、"类型安全"等心智模型需时间内化 工具链依赖：深度依赖自定义宏（@ViewModel），宏展开故障或编译器更新可能导致问题 本地化约束：LocalizableString仅能在使用localizingEncoder()的ViewModel中工作，不可用于Fluent JSONB等持久化类型，边界需仔细把控 嵌套类型限制：仅当子类型仅被单一父类型使用且不代表完整ViewModel时才可嵌套，否则需顶层定义，决策规则增加认知负担 YAML手动维护：本地化字符串需同步维护YAML文件，无自动化提取工具，存在键名拼写错误风险 服务端耦合：Server-Hosted模式需要服务端实现对应Factory，前后端需协同开发 适合人群 中大型SwiftUI项目团队：需要严格架构规范、多人协作的代码库 本地化需求复杂的应用：支持多语言、需处理复数、语境依赖文本的场景 全栈Swift开发者：使用Vapor等框架实现服务端渲染，需要前后端共享ViewModel定义 追求类型安全的团队：希望用编译期检查替代运行时错误处理的开发者 常规风险 宏生成代码调试困难：当@ViewModel展开不符合预期时，需检查宏展开结果，诊断链路较长 本地化键名漂移：YAML键名与Swift属性名需保持同步，重构时易遗漏更新导致运行时缺省回退 模式混用混淆：同一项目中两种托管模式并存，新开发者可能误用模式导致本地化时机错误（服务端应在编码期本地化，客户端在渲染期） 过度工程化风险：简单场景（如静态页面）可能不需要完整FOSMVVM架构，强制应用会增加不必要的抽象层 版本锁定：技能版本历史显示持续迭代（最新2.7），架构变更可能导致存量代码需要迁移 使用建议 建议配合fosmvvm-fields-generator（表单验证）和fosmvvm-leaf-view-generator（模板渲染）形成完整工具链。首次使用时务必完整阅读FOSMVVMArchitecture.md建立架构心智模型，再从此技能入手实践。 原始说明 Generate FOSMVVM-compliant SwiftUI ViewModels with client- or server-hosted factories, localization bindings, and stub factories for screens and components.