用途:在需要“新建项目”“创建项目”“初始化 Flutter”时,按 Clean Architecture 生成一个可运行、可分析的 Flutter 项目骨架。
主要能力:先收集项目名(snake_case)、组织名、描述和实体名;再选择领域模式(Simple、Stateful、Categorized、Tracked、Relational、Custom),分别生成单实体 CRUD、带状态字段、带分类关系、时间追踪、多实体关系或自定义字段的 Freezed 实体;随后选择状态管理(Riverpod 推荐或 BLoC)与功能预设(Minimal、Essential、Full),生成 core/features/shared 目录结构、Drift 数据库、GetIt + injectable 依赖注入、错误类型等基础文件。
使用方式:要求较新的稳定 Flutter SDK(Dart >= 3.9),先 flutter --version,必要时 flutter upgrade。依赖需在一条 flutter pub add 命令中一次性安装,避免解析器冲突;示例命令包含 freezed_annotation、drift、get_it、injectable、flutter_riverpod、go_router、dio、fpdart 及对应 dev 包,BLoC 方案则替换为 flutter_bloc。之后执行 flutter create --org <org> --project-name <name> <name>,生成文件,运行 flutter pub get 与 dart run build_runner build --delete-conflicting-outputs,最后必须 flutter analyze 且 0 错误,再 git init 并提交初始提交。
适用场景:需要快速搭建结构统一、带代码生成与依赖注入的 Flutter 新项目。
限制:Custom 模式无专用模板,需自行设计字段;若 pubspec 出现 -dev/-beta 预发布版本,必须依赖 flutter analyze 验证代码生成是否成功;资料未提供收费、价格、平台支持范围等信息。