什么是flutter-schema
Flutter GetX 三层架构规范（flutter-schema）是一套专为 Flutter + GetX 项目设计的工程化解决方案，旨在通过清晰的纵向分层和模块化管理，提升大型 Flutter 应用的可维护性与开发效率。该架构采用 core、shared、modules 三个层级，形成自上而下单向依赖的结构体系：modules 层依赖 core 与 shared，而 shared 层又依赖 core，确保业务逻辑与基础能力的解耦。这种设计特别适合中大型 Flutter 项目，能够有效应对功能迭代频繁、团队协作复杂的场景。
该规范不仅定义了各层的职责边界——core 负责全局配置、路由、服务与通用组件；shared 提供数据模型、网络请求、本地存储等可复用能力；modules 则聚焦具体业务功能的实现——还配套提供了标准化的目录结构模板与命名约定。通过统一的代码组织方式，开发者可以快速理解项目结构，降低新成员上手成本，同时便于后续的代码审查与重构工作。
此外，flutter-schema 支持自动化脚手架生成功能，用户可通过命令行工具一键创建完整的目录骨架或单个业务模块，极大简化了从零开始搭建项目的繁琐流程。无论是新项目初始化还是已有模块扩展，该工具都能显著减少重复劳动，让开发者更专注于业务逻辑本身。
核心功能特点
- 采用 core + shared + modules 纵向分层架构，明确各层职责与依赖关系
- 提供标准化目录结构与命名规范，统一项目代码组织方式
- 支持命令行脚手架生成，可快速创建完整项目骨架或单个业务模块
- 强制模块间通过路由通信，禁止同级模块直接 import，保障解耦
- Logic 层继承 BaseController 基类，视图文件以 _view 结尾，类名以 Page/View 结尾
- 仅允许上层依赖下层，Logic 不持有 BuildContext，避免 UI 耦合
适用场景
flutter-schema 特别适用于需要长期维护的中大型 Flutter 项目，尤其是在团队规模扩大、功能模块增多时，其分层架构能有效隔离不同层次的职责，防止代码混乱。例如，在一个电商应用中，订单管理、用户中心、商品展示等功能可以分别拆分为独立的 modules 模块，每个模块内部遵循 GetX 的三文件结构（Binding + Logic + State），而支付服务、API 封装、主题配置等通用能力则集中在 core 层，公共的数据模型和工具函数放在 shared 层。这样既保证了业务逻辑的独立演进，也方便了跨模块的功能复用。
对于新项目启动或已有项目重构，该规范同样具有显著价值。使用 scaffold 能力可在数秒内生成包含核心配置、路由系统、基础服务与首个业务模块的完整目录结构，避免手动创建文件夹和文件的繁琐操作。同时，统一的命名规则和代码组织方式使代码评审更加高效，团队成员能快速定位问题所在，减少沟通成本。尤其在敏捷开发环境中，这种标准化的架构为持续集成和自动化测试提供了良好的基础支撑。
此外，当需要新增功能模块时，只需在 modules 目录下按规范新建对应文件夹，并通过 validate.py 脚本生成页面骨架，即可立即开始编码。这种方式不仅提升了开发速度，也确保了所有模块在结构上保持一致，降低了后期维护难度。因此，无论是初创公司快速验证产品原型，还是成熟企业推进复杂系统开发，flutter-schema 都是一款值得采用的工程化工具。