状态管理的本质：状态管理的核心是 “状态与 UI 解耦”，让状态的修改和 UI 的更新分离，提高代码的可维护性。技术选型原则局部简单状态：优先使用setState；跨组件共享状态：使用 Provider（轻量、易上手）；复杂业务逻辑：可考虑 Bloc/Riverpod 等更重型的状态管理方案。性能优化关键减少重建范围（Consumer/Selector）；避免不必要的监听（listen: fals

Riverpod 作为新一代状态管理方案，通过其无上下文访问、强类型系统和灵活的提供者机制，为 Flutter 应用开发带来了显著的改进。特别是在中大型项目中，Riverpod 能够有效解决状态共享、类型安全和代码组织等核心问题。掌握 Riverpod 不仅能够提升开发效率，更能为应用的长期维护奠定坚实基础。首先创建，定义商品实体：dart/// 商品模型// 商品ID// 商品名称// 商品价格

dart// 首页（路由栈的初始页面）@overrideappBar: AppBar(title: const Text('首页')),// 核心：push入栈，跳转到详情页},child: const Text('跳转到详情页'),),),// 封装跳转逻辑（规范写法，避免直接在onPressed写业务代码）// MaterialPageRoute：Material风格的路由，包含默认转场动画)

dart@override// 动画控制器（核心）// 进度动画（0.0-1.0）// 旋转动画（0-2π）// 颜色动画（蓝色→红色→绿色）@override// 初始化动画控制器// 动画时长// vsync：防止动画在后台运行（需混入SingleTickerProviderStateMixin）// 动画范围（0.0-1.0）// 1. 进度动画（线性）// 2. 旋转动画（0-2π）//

dart@override// 动画控制器（核心）// 进度动画（0.0-1.0）// 旋转动画（0-2π）// 颜色动画（蓝色→红色→绿色）@override// 初始化动画控制器// 动画时长// vsync：防止动画在后台运行（需混入SingleTickerProviderStateMixin）// 动画范围（0.0-1.0）// 1. 进度动画（线性）// 2. 旋转动画（0-2π）//

基础请求：封装全局 Dio 实例，统一处理请求参数和数据解析；拦截器：实现请求头自动添加、响应统一解析、Token 过期处理；缓存策略：减少重复请求，提升页面加载速度；高级功能：断点续传下载、文件上传、取消请求等，适配复杂业务场景。网络请求是 Flutter 应用的 “生命线”，写得规范与否直接影响应用的稳定性和用户体验。比如统一的异常处理能避免崩溃，缓存策略能提升加载速度，断点续传能优化大文件下

从 Provider 到 Riverpod 2.0 的迁移，本质上是从 “命令式、上下文绑定、可变状态” 向 “声明式、上下文解耦、不可变状态” 的思维转变。Riverpod 2.0 不仅解决了 Provider 的核心痛点，还通过异步状态管理、细粒度重建、缓存机制等特性，大幅提升了状态管理的性能和可维护性。先替换根容器为；逐步将重构为；将 Widget 中的Consumer替换为WidgetRe

实际开发中，我们需要给列表、网格等多个组件添加 “逐个入场” 的交错动画。下面封装一个通用的，支持自定义动画延迟和属性。dart// 通用交错动画组件// 子组件列表// 每个组件的动画延迟（毫秒）// 单个组件动画时长super.key,this.delayStep = 100, // 默认每个延迟100msthis.duration = 300, // 默认时长300ms});@overrid

dart/// 路由操作类型枚举push, // 普通跳转（入栈）pushReplacement, // 替换当前页面pushAndRemoveUntil, // 跳转并清空之前的栈pop, // 返回上一页popUntil, // 返回指定页面/// 路由参数基类（所有页面参数需继承此类）/// 路由路径（与路由表中的path对应）/// 转换为Map（用于传递参数）/// 从Map解析参数（子

dart/// 分布式同步状态枚举idle, // 空闲syncing, // 同步中success, // 同步成功failed, // 同步失败offline, // 离线（本地缓存）conflict, // 数据冲突/// 冲突解决策略枚举lastWriteWin, // 最后修改优先（默认）devicePriority, // 设备优先级（指定设备的修改优先）custom, // 自定义策