用途:当用户在项目中使用 Riverpod 或 Flutter 状态管理时提供模式与规范建议,覆盖 provider 设计、代码生成、异步状态、依赖注入、性能与测试。
主要能力:推荐使用 @riverpod 注解与 riverpod_generator 代码生成;异步状态优先 AsyncNotifierProvider,实时流用 StreamProvider,同步状态用 NotifierProvider,派生值用 Provider。支持 Repository 三层架构、family 参数化 provider、autoDispose 与 keepAlive 缓存、错误处理及 ProviderContainer.test 测试。
必要用法:添加依赖后运行生成器,命令为 dart run build_runner watch -d,或 dart run build_runner build --delete-conflicting-outputs。每个 provider 文件需带 part 'filename.g.dart';。Riverpod 3.x 使用 flutter_riverpod: ^3.0.0、riverpod_annotation: ^4.0.0、riverpod_generator: ^4.0.0、riverpod_lint: ^3.0.0,并在 analysis_options.yaml 注册 riverpod_lint;2.x 为旧版,需额外 custom_lint 依赖。
性能要点:build 中使用 ref.watch 或 ref.select 订阅,避免在 build 用 ref.read;不要在循环中 watch,列表项拆分为 ConsumerWidget;副作用用 ref.listen。
限制:资料仅给出上述版本、命令与模式,未提供安装之外的定价、平台或实际效果信息;具体版本兼容性以项目实际解析结果为准。