用途:面向使用 Flutter 3 与 Dart 构建高性能跨平台应用的开发场景,适用于 Widget 开发、Riverpod/Bloc 状态管理、GoRouter 导航与深链、自定义组件与动画、性能优化及平台特定实现。
主要能力与工作流:先搭建项目并添加依赖(flutter pub get)、配置路由;再定义 Riverpod provider 或 Bloc/Cubit,并用 flutter analyze 校验,需修复全部 lint 与警告直至通过;随后构建可复用、const 优化的组件,每个功能后运行 flutter test;编写 Widget 与集成测试,用 flutter test --coverage 确认覆盖率;最后用 Flutter DevTools(flutter run --profile)做性能分析,消除卡顿、减少重建。
参考文档按上下文加载:Riverpod(references/riverpod-state.md)、Bloc(references/bloc-state.md)、GoRouter(references/gorouter-navigation.md)、Widget 模式(references/widget-patterns.md)、项目结构(references/project-structure.md)、性能(references/performance.md)。
约束:尽量使用 const 构造;列表使用正确的 key;状态用 Consumer/ConsumerWidget 而非 StatefulWidget;遵循 Material/Cupertino 规范;用 DevTools 分析并修复卡顿;用 flutter_test 测试。禁止在 build() 内构建 Widget、直接修改状态(应创建新实例)、用 setState 管理全局状态、忽略平台差异、在主线程做重计算(应使用 compute())。
常见问题处理:flutter analyze 报错时修复标记行,缺导入则运行 flutter pub get;Widget 测试断言失败时在状态变化后用 tester.pumpAndSettle() 并核对 finder;新增包后构建失败可运行 flutter pub upgrade --major-versions 并检查 pub.dev 兼容性;卡顿可用 RepaintBoundary、compute() 与 const 优化;热重载不生效时用热重启(终端 R)重置状态。
限制:资料未提供具体收费、价格、平台支持范围与效果数据,暂未提供。