claude-skills 的 flutter-expert 技能库Riverpod 状态管理实战指南【免费下载链接】claude-skills67 Specialized Skills for Full-Stack Developers. Transform Claude Code into your expert pair programmer.项目地址: https://gitcode.com/GitHub_Trending/claud/claude-skills导读Riverpod 是当前 Flutter 社区主流的声明式状态管理方案本指南以 claude-skills 仓库中 flutter-expert 技能 的核心参考文档 riverpod-state.md 为主体系统讲解 Provider 类型选型、Riverpod 2.0 Notifier 模式、Widget 中的消费方式并结合仓库中的工程配置与性能规范给出可直接落地的完整方案。读完本文你将掌握从定义状态、处理异步数据到精确控制组件重建的 Riverpod 全链路写法。一、Provider 类型按场景选择正确的状态容器Riverpod 的核心思想是把“状态”与“如何获取状态”统一抽象为顶层可组合的 Provider。flutter-expert技能文档将常用 Provider 分为三类分别对应同步状态、一次性异步操作与实时数据流import package:flutter_riverpod/flutter_riverpod.dart; // Simple state —— 简单可变状态 final counterProvider StateProviderint((ref) 0); // Async state (API calls) —— 一次性异步操作如请求用户列表 final usersProvider FutureProviderListUser((ref) async { final api ref.read(apiProvider); return api.getUsers(); }); // Stream state (real-time) —— 实时数据流如聊天消息 final messagesProvider StreamProviderListMessage((ref) { return ref.read(chatServiceProvider).messagesStream; });1.1 各 Provider 的核心特性Provider典型用途状态值注意事项Provider计算/派生值、依赖注入如apiProvider任何类型状态不可变适合作为依赖门面StateProvider简单计数器、开关、输入框内容可变单值状态变化会通知所有监听者复杂对象建议用 NotifierFutureProvider一次性 API 调用、文件读取AsyncValueT自带 loading / error / data 三态StreamProviderWebSocket、消息推送、订阅AsyncValueT流中断时自动进入 error 态NotifierProvider带方法的复杂状态增删改查可变对象/集合Riverpod 2.0 推荐写法AsyncNotifierProvider异步状态 方法登录、更新资料AsyncValueT支持在方法内更新异步状态从源码结构看flutter-expert技能在 riverpod-state.md 中把Provider定位为“Computed/derived values”这意味着它常被用作依赖注入的基础设施——例如上例中usersProvider通过ref.read(apiProvider)取得 API 客户端而不是在 Provider 内部直接 new 一个实例从而保证依赖可替换、可测试。1.2 数据获取依赖与生命周期注意FutureProvider/StreamProvider中通过ref.read(...)读取其他 Provider这是 Riverpod 的依赖机制当被依赖的apiProvider或chatServiceProvider重建时Riverpod 会自动让依赖它的 Provider 失效并重新执行Provider 默认是懒加载的只有被watch或read时才创建并在没有监听者后自动销毁天然规避了传统状态管理中的内存泄漏问题。二、Riverpod 2.0 Notifier 模式复杂状态的正确打开方式对于包含增删改查方法、需要封装业务逻辑的状态技能文档推荐使用 Riverpod 2.0 的Notifier与AsyncNotifier配合riverpod注解与代码生成器将状态与操作内聚为一个类。2.1 同步 NotifierTodo 列表riverpod class TodoList extends _$TodoList { override ListTodo build() []; void add(Todo todo) { state [...state, todo]; } void toggle(String id) { state [ for (final todo in state) if (todo.id id) todo.copyWith(completed: !todo.completed) else todo, ]; } void remove(String id) { state state.where((t) t.id ! id).toList(); } }要点解读build()返回初始状态同时承担“依赖声明”职责——build()中ref.watch的 Provider 变化会触发状态重建所有方法都通过不可变更新产生新状态[...state]、for集合、where这与 SKILL.md 的 MUST NOT DO 约束中“Mutate state directly (always create new instances)”完全一致——绝不允许直接修改原对象copyWith依赖模型类实现仓库中常配合freezed生成不可变数据类见后文工程配置。2.2 异步 Notifier带方法调用与错误处理的用户资料// Async Notifier riverpod class UserProfile extends _$UserProfile { override FutureUser build() async { return ref.read(apiProvider).getCurrentUser(); } Futurevoid updateName(String name) async { state const AsyncValue.loading(); state await AsyncValue.guard(() async { final updated await ref.read(apiProvider).updateUser(name: name); return updated; }); } }这里的AsyncValue.guard是 Riverpod 提供的语法糖自动捕获异步异常并封装为AsyncError免去手写try/catch。整个流程为进入 loading → 调用 API → 成功写回 data / 失败写回 errorUI 层通过AsyncValue.when统一消费。从实现看build()内部读取的apiProvider是跨 Provider 共享的依赖这也呼应了 project-structure.md 中 Feature 目录结构里providers/层的设计——每个 feature 的 Provider 集中放置便于统一管理与复用。三、在 Widget 中消费状态ConsumerWidget、select 与 AsyncValue技能文档明确推荐用ConsumerWidget而非StatefulWidget消费状态并给出三种典型场景的完整代码。3.1 基础消费watch 驱动重建// ConsumerWidget (recommended) class TodoScreen extends ConsumerWidget { const TodoScreen({super.key}); override Widget build(BuildContext context, WidgetRef ref) { final todos ref.watch(todoListProvider); return ListView.builder( itemCount: todos.length, itemBuilder: (context, index) { final todo todos[index]; return ListTile( title: Text(todo.title), leading: Checkbox( value: todo.completed, onChanged: (_) ref.read(todoListProvider.notifier).toggle(todo.id), ), ); }, ); } }ref.watch建立订阅关系状态变化时仅重建当前 ConsumerWidget不会波及整棵子树ref.read(...notifier)在事件回调如onChanged中读取 Notifier 并调用方法永远不要在回调中使用 watch因为状态提升到了TodoList中这个列表组件在滚动、重建时不会丢失状态。3.2 精确重建select 只监听关心的字段// Selective rebuilds with select class UserAvatar extends ConsumerWidget { const UserAvatar({super.key}); override Widget build(BuildContext context, WidgetRef ref) { final avatarUrl ref.watch(userProvider.select((u) u?.avatarUrl)); return CircleAvatar( backgroundImage: avatarUrl ! null ? NetworkImage(avatarUrl) : null, ); } }当userProvider中的姓名、年龄等其他字段变化时select会通过比较新旧的avatarUrl来决定是否重建从而把重建范围压缩到最小。这与仓库 performance.md 中的“Selective Provider Watching”优化相互印证// ❌ Rebuilds on any user change final user ref.watch(userProvider); return Text(user.name); // ✅ Only rebuilds when name changes final name ref.watch(userProvider.select((u) u.name)); return Text(name);对于高频更新的列表项、头像这类组件select是避免整屏抖动jank的关键手段。3.3 异步状态三态渲染AsyncValue.when// Async state handling class UserProfileScreen extends ConsumerWidget { override Widget build(BuildContext context, WidgetRef ref) { final userAsync ref.watch(userProfileProvider); return userAsync.when( data: (user) Text(user.name), loading: () const CircularProgressIndicator(), error: (err, stack) Text(Error: $err), ); } }AsyncValue把 loading / error / data 三种状态统一封装UI 层只需一个when即可完整覆盖不再需要手写状态枚举与判断分支。error回调中的stack参数可用于上报崩溃堆栈。四、工程落地依赖配置与 ProviderScope 入口Riverpod 不是开箱即用的空谈仓库 project-structure.md 给出了配套的pubspec.yaml依赖方案dependencies: flutter: sdk: flutter # State Management flutter_riverpod: ^2.5.0 riverpod_annotation: ^2.3.0 # Navigation go_router: ^14.0.0 # Networking dio: ^5.4.0 # Code Generation freezed_annotation: ^2.4.0 json_annotation: ^4.8.0 dev_dependencies: build_runner: ^2.4.0 riverpod_generator: ^2.4.0 freezed: ^2.5.0 json_serializable: ^6.8.0 flutter_lints: ^4.0.0flutter_riverpod运行时核心库提供ProviderScope、ConsumerWidget等riverpod_annotationriverpod_generator为riverpod注解提供代码生成支持配合dart run build_runner build生成对应的 Providerfreezedjson_serializable为不可变模型类与序列化生成样板代码支撑copyWith、等不可变语义go_router路由方案与 Riverpod 组合使用时可将routerProvider定义为 Provider 统一管理见 gorouter-navigation.md。入口处必须用ProviderScope包裹根组件所有 Provider 的容器Container由此建立// main.dart void main() async { WidgetsFlutterBinding.ensureInitialized(); await Hive.initFlutter(); runApp(const ProviderScope(child: MyApp())); } // app.dart class MyApp extends ConsumerWidget { const MyApp({super.key}); override Widget build(BuildContext context, WidgetRef ref) { final router ref.watch(routerProvider); return MaterialApp.router( routerConfig: router, theme: AppTheme.light, darkTheme: AppTheme.dark, themeMode: ThemeMode.system, ); } }ProviderScope是 Riverpod 的根容器负责所有 Provider 的生命周期与依赖图管理MyApp本身也是ConsumerWidget通过ref.watch(routerProvider)把路由配置接入状态系统实现“路由也是状态”的统一模型。五、性能与工程规范与技能库其他文档的呼应flutter-expert技能不是孤立的知识点而是围绕状态管理的一整套规范。将 riverpod-state.md 与其他参考文档交叉阅读可以得到完整的性能护栏场景推荐做法出处状态消费用Consumer/ConsumerWidget不用StatefulWidgetSKILL.md 约束状态更新永远创建新实例禁止直接 mutateSKILL.md 约束细粒度重建ref.watch(provider.select(...))performance.md静态组件全部加const避免不必要的重建performance.md长列表ListView.builder懒加载 合理的 Keywidget-patterns.md大量图片CachedNetworkImage/cacheWidth内存缩放performance.md重计算移入compute()isolate不阻塞 UI 线程performance.md典型的反模式是把全应用状态塞进setState导致某处变更引发整棵子树重建。技能文档给出的正确姿势是// ❌ WRONG: app-wide state in setState —— 引发整个子树重建 class _BadCounterState extends StateBadCounter { int _count 0; void _inc() setState(() _count); } // ✅ CORRECT: scoped Riverpod consumer —— 仅局部重建 class GoodCounter extends ConsumerWidget { const GoodCounter({super.key}); override Widget build(BuildContext context, WidgetRef ref) { final count ref.watch(counterProvider); return IconButton( onPressed: () ref.read(counterProvider.notifier).increment(), icon: const Icon(Icons.add), // const on static widgets ); } }5.1 Riverpod 与 Bloc 的选型边界仓库同时维护了 bloc-state.md 参考文档两者的选型边界在技能库中有明确划分Use CaseRecommendedSimple mutable stateRiverpodEvent-driven workflowsBlocForms, auth, wizardsBlocFeature modulesBloc简单可变状态、异步数据拉取、实时流用 Riverpod 最轻量需要显式事件驱动、严格可预测的状态转移如表单、鉴权、向导流程则适合 Bloc/Cubit。两者在同一工程中可以共存例如全局用户态用 Riverpod复杂的登录流程用 Bloc。六、开发与验证流程flutter-expert技能 SKILL.md 给出了状态管理落地的标准验证链路# 1. 添加依赖并解析 flutter pub get # 2. 静态分析必须清零再继续 flutter analyze # 3. 每个功能完成后跑测试 flutter test # 4. 覆盖率确认 flutter test --coverage # 5. Profile 模式定位性能瓶颈 flutter run --profile常见故障对照摘自技能库 Troubleshooting症状可能原因恢复手段flutter analyze报错未解析的 import、缺少const修复报错行import 缺失时执行flutter pub getWidget 测试断言失败异步状态未 settle状态变更后使用tester.pumpAndSettle()热重载不生效Notifier中状态未重置使用热重启终端按R重置应用状态掉帧/jank昂贵的build()、无缓存组件使用RepaintBoundary、select()缩小重建范围七、快速参考Provider 选型表以下为技能文档原生的速查表建议贴在编辑器旁作为日常选型依据ProviderUse CaseProviderComputed/derived valuesStateProviderSimple mutable stateFutureProviderAsync operations (one-time)StreamProviderReal-time data streamsNotifierProviderComplex state with methodsAsyncNotifierProviderAsync state with methods八、延伸阅读技能主文档与使用约束skills/flutter-expert/SKILL.md含 When to Use、Core Workflow、Troubleshooting本文主体出处skills/flutter-expert/references/riverpod-state.md事件驱动方案对比skills/flutter-expert/references/bloc-state.md工程目录与依赖配置skills/flutter-expert/references/project-structure.md性能优化细则skills/flutter-expert/references/performance.md路由与状态联动skills/flutter-expert/references/gorouter-navigation.md组件与 Key 规范skills/flutter-expert/references/widget-patterns.md说明本文所有代码与配置均取自 claude-skills 仓库中 flutter-expert 技能的参考文档与工程规范版本以仓库当前内容为准flutter_riverpod ^2.5.0等。使用riverpod代码生成时请确保已安装riverpod_generator并运行build_runner生成文件会随源码一起参与编译。【免费下载链接】claude-skills67 Specialized Skills for Full-Stack Developers. Transform Claude Code into your expert pair programmer.项目地址: https://gitcode.com/GitHub_Trending/claud/claude-skills创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 claude-skills 的 flutter-expert 技能库：Riverpod 状态管理实战指南
claude-skills 的 flutter-expert 技能库Riverpod 状态管理实战指南【免费下载链接】claude-skills67 Specialized Skills for Full-Stack Developers. Transform Claude Code into your expert pair programmer.项目地址: https://gitcode.com/GitHub_Trending/claud/claude-skills导读Riverpod 是当前 Flutter 社区主流的声明式状态管理方案本指南以 claude-skills 仓库中 flutter-expert 技能 的核心参考文档 riverpod-state.md 为主体系统讲解 Provider 类型选型、Riverpod 2.0 Notifier 模式、Widget 中的消费方式并结合仓库中的工程配置与性能规范给出可直接落地的完整方案。读完本文你将掌握从定义状态、处理异步数据到精确控制组件重建的 Riverpod 全链路写法。一、Provider 类型按场景选择正确的状态容器Riverpod 的核心思想是把“状态”与“如何获取状态”统一抽象为顶层可组合的 Provider。flutter-expert技能文档将常用 Provider 分为三类分别对应同步状态、一次性异步操作与实时数据流import package:flutter_riverpod/flutter_riverpod.dart; // Simple state —— 简单可变状态 final counterProvider StateProviderint((ref) 0); // Async state (API calls) —— 一次性异步操作如请求用户列表 final usersProvider FutureProviderListUser((ref) async { final api ref.read(apiProvider); return api.getUsers(); }); // Stream state (real-time) —— 实时数据流如聊天消息 final messagesProvider StreamProviderListMessage((ref) { return ref.read(chatServiceProvider).messagesStream; });1.1 各 Provider 的核心特性Provider典型用途状态值注意事项Provider计算/派生值、依赖注入如apiProvider任何类型状态不可变适合作为依赖门面StateProvider简单计数器、开关、输入框内容可变单值状态变化会通知所有监听者复杂对象建议用 NotifierFutureProvider一次性 API 调用、文件读取AsyncValueT自带 loading / error / data 三态StreamProviderWebSocket、消息推送、订阅AsyncValueT流中断时自动进入 error 态NotifierProvider带方法的复杂状态增删改查可变对象/集合Riverpod 2.0 推荐写法AsyncNotifierProvider异步状态 方法登录、更新资料AsyncValueT支持在方法内更新异步状态从源码结构看flutter-expert技能在 riverpod-state.md 中把Provider定位为“Computed/derived values”这意味着它常被用作依赖注入的基础设施——例如上例中usersProvider通过ref.read(apiProvider)取得 API 客户端而不是在 Provider 内部直接 new 一个实例从而保证依赖可替换、可测试。1.2 数据获取依赖与生命周期注意FutureProvider/StreamProvider中通过ref.read(...)读取其他 Provider这是 Riverpod 的依赖机制当被依赖的apiProvider或chatServiceProvider重建时Riverpod 会自动让依赖它的 Provider 失效并重新执行Provider 默认是懒加载的只有被watch或read时才创建并在没有监听者后自动销毁天然规避了传统状态管理中的内存泄漏问题。二、Riverpod 2.0 Notifier 模式复杂状态的正确打开方式对于包含增删改查方法、需要封装业务逻辑的状态技能文档推荐使用 Riverpod 2.0 的Notifier与AsyncNotifier配合riverpod注解与代码生成器将状态与操作内聚为一个类。2.1 同步 NotifierTodo 列表riverpod class TodoList extends _$TodoList { override ListTodo build() []; void add(Todo todo) { state [...state, todo]; } void toggle(String id) { state [ for (final todo in state) if (todo.id id) todo.copyWith(completed: !todo.completed) else todo, ]; } void remove(String id) { state state.where((t) t.id ! id).toList(); } }要点解读build()返回初始状态同时承担“依赖声明”职责——build()中ref.watch的 Provider 变化会触发状态重建所有方法都通过不可变更新产生新状态[...state]、for集合、where这与 SKILL.md 的 MUST NOT DO 约束中“Mutate state directly (always create new instances)”完全一致——绝不允许直接修改原对象copyWith依赖模型类实现仓库中常配合freezed生成不可变数据类见后文工程配置。2.2 异步 Notifier带方法调用与错误处理的用户资料// Async Notifier riverpod class UserProfile extends _$UserProfile { override FutureUser build() async { return ref.read(apiProvider).getCurrentUser(); } Futurevoid updateName(String name) async { state const AsyncValue.loading(); state await AsyncValue.guard(() async { final updated await ref.read(apiProvider).updateUser(name: name); return updated; }); } }这里的AsyncValue.guard是 Riverpod 提供的语法糖自动捕获异步异常并封装为AsyncError免去手写try/catch。整个流程为进入 loading → 调用 API → 成功写回 data / 失败写回 errorUI 层通过AsyncValue.when统一消费。从实现看build()内部读取的apiProvider是跨 Provider 共享的依赖这也呼应了 project-structure.md 中 Feature 目录结构里providers/层的设计——每个 feature 的 Provider 集中放置便于统一管理与复用。三、在 Widget 中消费状态ConsumerWidget、select 与 AsyncValue技能文档明确推荐用ConsumerWidget而非StatefulWidget消费状态并给出三种典型场景的完整代码。3.1 基础消费watch 驱动重建// ConsumerWidget (recommended) class TodoScreen extends ConsumerWidget { const TodoScreen({super.key}); override Widget build(BuildContext context, WidgetRef ref) { final todos ref.watch(todoListProvider); return ListView.builder( itemCount: todos.length, itemBuilder: (context, index) { final todo todos[index]; return ListTile( title: Text(todo.title), leading: Checkbox( value: todo.completed, onChanged: (_) ref.read(todoListProvider.notifier).toggle(todo.id), ), ); }, ); } }ref.watch建立订阅关系状态变化时仅重建当前 ConsumerWidget不会波及整棵子树ref.read(...notifier)在事件回调如onChanged中读取 Notifier 并调用方法永远不要在回调中使用 watch因为状态提升到了TodoList中这个列表组件在滚动、重建时不会丢失状态。3.2 精确重建select 只监听关心的字段// Selective rebuilds with select class UserAvatar extends ConsumerWidget { const UserAvatar({super.key}); override Widget build(BuildContext context, WidgetRef ref) { final avatarUrl ref.watch(userProvider.select((u) u?.avatarUrl)); return CircleAvatar( backgroundImage: avatarUrl ! null ? NetworkImage(avatarUrl) : null, ); } }当userProvider中的姓名、年龄等其他字段变化时select会通过比较新旧的avatarUrl来决定是否重建从而把重建范围压缩到最小。这与仓库 performance.md 中的“Selective Provider Watching”优化相互印证// ❌ Rebuilds on any user change final user ref.watch(userProvider); return Text(user.name); // ✅ Only rebuilds when name changes final name ref.watch(userProvider.select((u) u.name)); return Text(name);对于高频更新的列表项、头像这类组件select是避免整屏抖动jank的关键手段。3.3 异步状态三态渲染AsyncValue.when// Async state handling class UserProfileScreen extends ConsumerWidget { override Widget build(BuildContext context, WidgetRef ref) { final userAsync ref.watch(userProfileProvider); return userAsync.when( data: (user) Text(user.name), loading: () const CircularProgressIndicator(), error: (err, stack) Text(Error: $err), ); } }AsyncValue把 loading / error / data 三种状态统一封装UI 层只需一个when即可完整覆盖不再需要手写状态枚举与判断分支。error回调中的stack参数可用于上报崩溃堆栈。四、工程落地依赖配置与 ProviderScope 入口Riverpod 不是开箱即用的空谈仓库 project-structure.md 给出了配套的pubspec.yaml依赖方案dependencies: flutter: sdk: flutter # State Management flutter_riverpod: ^2.5.0 riverpod_annotation: ^2.3.0 # Navigation go_router: ^14.0.0 # Networking dio: ^5.4.0 # Code Generation freezed_annotation: ^2.4.0 json_annotation: ^4.8.0 dev_dependencies: build_runner: ^2.4.0 riverpod_generator: ^2.4.0 freezed: ^2.5.0 json_serializable: ^6.8.0 flutter_lints: ^4.0.0flutter_riverpod运行时核心库提供ProviderScope、ConsumerWidget等riverpod_annotationriverpod_generator为riverpod注解提供代码生成支持配合dart run build_runner build生成对应的 Providerfreezedjson_serializable为不可变模型类与序列化生成样板代码支撑copyWith、等不可变语义go_router路由方案与 Riverpod 组合使用时可将routerProvider定义为 Provider 统一管理见 gorouter-navigation.md。入口处必须用ProviderScope包裹根组件所有 Provider 的容器Container由此建立// main.dart void main() async { WidgetsFlutterBinding.ensureInitialized(); await Hive.initFlutter(); runApp(const ProviderScope(child: MyApp())); } // app.dart class MyApp extends ConsumerWidget { const MyApp({super.key}); override Widget build(BuildContext context, WidgetRef ref) { final router ref.watch(routerProvider); return MaterialApp.router( routerConfig: router, theme: AppTheme.light, darkTheme: AppTheme.dark, themeMode: ThemeMode.system, ); } }ProviderScope是 Riverpod 的根容器负责所有 Provider 的生命周期与依赖图管理MyApp本身也是ConsumerWidget通过ref.watch(routerProvider)把路由配置接入状态系统实现“路由也是状态”的统一模型。五、性能与工程规范与技能库其他文档的呼应flutter-expert技能不是孤立的知识点而是围绕状态管理的一整套规范。将 riverpod-state.md 与其他参考文档交叉阅读可以得到完整的性能护栏场景推荐做法出处状态消费用Consumer/ConsumerWidget不用StatefulWidgetSKILL.md 约束状态更新永远创建新实例禁止直接 mutateSKILL.md 约束细粒度重建ref.watch(provider.select(...))performance.md静态组件全部加const避免不必要的重建performance.md长列表ListView.builder懒加载 合理的 Keywidget-patterns.md大量图片CachedNetworkImage/cacheWidth内存缩放performance.md重计算移入compute()isolate不阻塞 UI 线程performance.md典型的反模式是把全应用状态塞进setState导致某处变更引发整棵子树重建。技能文档给出的正确姿势是// ❌ WRONG: app-wide state in setState —— 引发整个子树重建 class _BadCounterState extends StateBadCounter { int _count 0; void _inc() setState(() _count); } // ✅ CORRECT: scoped Riverpod consumer —— 仅局部重建 class GoodCounter extends ConsumerWidget { const GoodCounter({super.key}); override Widget build(BuildContext context, WidgetRef ref) { final count ref.watch(counterProvider); return IconButton( onPressed: () ref.read(counterProvider.notifier).increment(), icon: const Icon(Icons.add), // const on static widgets ); } }5.1 Riverpod 与 Bloc 的选型边界仓库同时维护了 bloc-state.md 参考文档两者的选型边界在技能库中有明确划分Use CaseRecommendedSimple mutable stateRiverpodEvent-driven workflowsBlocForms, auth, wizardsBlocFeature modulesBloc简单可变状态、异步数据拉取、实时流用 Riverpod 最轻量需要显式事件驱动、严格可预测的状态转移如表单、鉴权、向导流程则适合 Bloc/Cubit。两者在同一工程中可以共存例如全局用户态用 Riverpod复杂的登录流程用 Bloc。六、开发与验证流程flutter-expert技能 SKILL.md 给出了状态管理落地的标准验证链路# 1. 添加依赖并解析 flutter pub get # 2. 静态分析必须清零再继续 flutter analyze # 3. 每个功能完成后跑测试 flutter test # 4. 覆盖率确认 flutter test --coverage # 5. Profile 模式定位性能瓶颈 flutter run --profile常见故障对照摘自技能库 Troubleshooting症状可能原因恢复手段flutter analyze报错未解析的 import、缺少const修复报错行import 缺失时执行flutter pub getWidget 测试断言失败异步状态未 settle状态变更后使用tester.pumpAndSettle()热重载不生效Notifier中状态未重置使用热重启终端按R重置应用状态掉帧/jank昂贵的build()、无缓存组件使用RepaintBoundary、select()缩小重建范围七、快速参考Provider 选型表以下为技能文档原生的速查表建议贴在编辑器旁作为日常选型依据ProviderUse CaseProviderComputed/derived valuesStateProviderSimple mutable stateFutureProviderAsync operations (one-time)StreamProviderReal-time data streamsNotifierProviderComplex state with methodsAsyncNotifierProviderAsync state with methods八、延伸阅读技能主文档与使用约束skills/flutter-expert/SKILL.md含 When to Use、Core Workflow、Troubleshooting本文主体出处skills/flutter-expert/references/riverpod-state.md事件驱动方案对比skills/flutter-expert/references/bloc-state.md工程目录与依赖配置skills/flutter-expert/references/project-structure.md性能优化细则skills/flutter-expert/references/performance.md路由与状态联动skills/flutter-expert/references/gorouter-navigation.md组件与 Key 规范skills/flutter-expert/references/widget-patterns.md说明本文所有代码与配置均取自 claude-skills 仓库中 flutter-expert 技能的参考文档与工程规范版本以仓库当前内容为准flutter_riverpod ^2.5.0等。使用riverpod代码生成时请确保已安装riverpod_generator并运行build_runner生成文件会随源码一起参与编译。【免费下载链接】claude-skills67 Specialized Skills for Full-Stack Developers. Transform Claude Code into your expert pair programmer.项目地址: https://gitcode.com/GitHub_Trending/claud/claude-skills创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考