什么是flutter-architecture
Flutter四层组件化+MVVM项目架构规范是一套专为Flutter应用开发设计的标准化工程结构方案，旨在提升代码可维护性、模块复用性和团队协作效率。该架构采用纵向分层模式，明确划分了app、business、component和foundation四个层级，每一层都有清晰的职责边界与单向依赖关系。其中，业务模块内部遵循MVVM（Model-View-ViewModel）设计模式，实现数据流与UI逻辑的解耦。这种结构不仅适用于新项目从零搭建，也支持现有项目逐步迁移或新增功能模块时的快速初始化。通过强制性的目录命名规范和依赖规则，有效避免了循环引用和模块间耦合问题，为大型团队长期迭代提供了稳定可靠的架构基础。
核心功能特点
- 严格的四层纵向依赖结构：app → business → component → foundation，确保依赖单向流动
- 业务模块内完整实现MVVM架构：Page/View → ViewModel → Repository → Model，清晰分离关注点
- 支持一键创建标准目录结构，包括全量搭建新项目或增量添加新业务模块
- 强制统一的命名规范，如page文件对应XxxPage类，view文件对应XxxView类，禁止使用widget关键字
- 模块间仅允许通过路由通信，禁止同级业务模块直接import，降低耦合度
- 提供完整的Code Review标准与代码示例，保障架构落地一致性
适用场景
该架构特别适合中大型Flutter项目的长期演进需求，尤其适用于需要多人协作、持续集成和频繁功能扩展的应用场景。例如，当一个团队从单一功能App发展为包含多个独立业务线（如电商、社交、教育等）的超级App时，此架构能清晰隔离各业务模块，避免代码混杂导致的维护困难。同时，对于需要高度复用通用能力（如支付、推送、分享）的团队而言，component层提供了标准化的能力封装，可在不同项目中无缝复用。此外，在引入新成员或进行代码评审时，这套规范显著降低了学习成本和技术债务风险，确保所有开发者遵循统一的设计原则。无论是初创公司快速验证产品原型，还是成熟企业推进系统重构，该架构都能提供高效、可扩展的工程支撑。