Dart/Flutter 模式
使用场景
在以下情况使用此技能：
- 开始新的 Flutter 功能，需要状态管理、导航或数据访问的惯用模式
- 审查或编写 Dart 代码，需要空安全、密封类型或异步组合的指导
- 搭建新的 Flutter 项目，在 BLoC、Riverpod 或 Provider 之间做选择
- 实现安全的 HTTP 客户端、WebView 集成或本地存储
- 为 Flutter 组件、Cubit 或 Riverpod 提供者编写测试
- 使用认证守卫配置 GoRouter
工作原理
此技能提供按关注点组织的、可直接复制粘贴的 Dart/Flutter 代码模式：
- 空安全 — 避免
!，优先使用?./??/模式匹配 - 不可变状态 — 密封类、
freezed、copyWith - 异步组合 — 并发
Future.wait、BuildContext后安全使用await - 组件架构 — 提取为类（而非方法）、
const传播、作用域重建 - 状态管理 — BLoC/Cubit 事件、Riverpod 通知器和派生提供者
- 导航 — 通过
refreshListenable实现带响应式认证守卫的 GoRouter - 网络请求 — 带拦截器的 Dio、带一次性重试守卫的令牌刷新
- 错误处理 — 全局捕获、
ErrorWidget.builder、Crashlytics 集成 - 测试 — 单元测试（BLoC 测试）、组件测试（ProviderScope 覆盖）、使用假对象而非模拟对象
示例
// Sealed state — prevents impossible states
sealed class AsyncState<T> {}
final class Loading<T> extends AsyncState<T> {}
final class Success<T> extends AsyncState<T> { final T data; const Success(this.data); }
final class Failure<T> extends AsyncState<T> { final Object error; const Failure(this.error); }
// GoRouter with reactive auth redirect
final router = GoRouter(
refreshListenable: GoRouterRefreshStream(authCubit.stream)…
