核心用法
本 Skill 是一套面向 Flutter 开发者的工程化避坑指南，通过 Critical Rules 与分主题文档（state.md、widgets.md、async.md、navigation.md、performance.md、platform.md）系统梳理框架层面的常见陷阱。核心聚焦于三大维度：
1. 状态管理：强调 setState 必须在 mounted 检查后调用，列表项必须携带 Key 防止重排后状态错位，StatefulWidget 重建机制与 Key 的关联；
2. 异步安全：FutureBuilder 的 Future 缓存策略、异步间隙后的 BuildContext 有效性校验、Navigator.pop 返回值的错误处理；
3. 性能与资源：const 构造器减少重建开销、GlobalKey 的昂贵成本与回调替代方案、ScrollController/Timer/Subscription 的完整 dispose、图片缓存选型。
显著优点
- 问题驱动：每条规则对应真实崩溃或性能事故（如 setState after dispose 引发 FlutterError），具备强场景关联；
- 体系完整：覆盖 UI 构建、状态生命周期、导航、平台通道、性能优化等全链路；
- 即时可用：Quick Reference 表格实现主题到文档的快速索引，适合作为 IDE 旁查手册。
潜在局限
- 未涉及 Riverpod/Bloc 等现代状态管理框架的深度对比，对复杂业务架构的指引有限；
- 平台通道章节仅提示异常捕获，未展开 MethodChannel 的线程模型与内存对齐细节；
- 缺乏与特定 Flutter 版本（如 3.x Impeller 渲染引擎）的兼容性说明。
适合人群
- 初级/中级 Flutter 开发者，需系统性规避框架陷阱；
- 从 Android/iOS 原生转型 Flutter 的工程师，理解 Widget 与 ViewController/Activity 的生命周期差异；
- 代码审查者，作为 Checklist 快速识别潜在风险代码。
常规风险
- 过度依赖 GlobalKey 警告：若开发者误将此理解为"完全禁用"，可能在必要时回避合理用法；
- dispose 完整性：规则依赖开发者自觉性，无静态检测工具配套时易遗漏；
- 异步间隙风险：
mounted检查为运行时防御，无法编译期保证，复杂嵌套异步代码仍存在上下文逃逸可能。