Flutter 文档看了一周，真正写业务的时候还在想 Widget 该怎么嵌套？Flutter 学习曲线陡在「语法好懂、组件无穷」，新手最需要的不是教程，是可直接跑通的完整示例。这份资源整合 20MB 的 Flutter 官方 samples 仓库，覆盖所有常用场景。

[判断标准] 你的项目是否适合用 Flutter

符合任意两项就该选：需要 iOS+Android 双端、需要一套代码搞定 UI、需要 60fps 动画、需要 Material 3 与 Cupertino 双风格、需要快速迭代原型。

[关键参数] Widget 树与状态管理的选择策略

简单页面用 StatefulWidget；中型项目用 Provider；复杂业务用 Riverpod/Bloc。setState 调用次数控制在 5 次/帧以内，长列表务必用 ListView.builder 懒加载。

[避坑点] 不要在 build 里做异步操作

build() 必须同步返回 Widget。任何网络请求、数据解析、IO 操作都放进 initState() 或事件回调。资源里给出符合规范的实战代码模板。

[易踩坑] iOS Pods 路径超长问题

Flutter iOS 示例里 Pods 嵌套层级常超过 Windows MAX_PATH 260 字符限制。资源包已经剔除长路径子目录，源码程序直接 flutter run 即可启动。

[场景建议] 五类高频 Flutter 示例

①基础组件：按钮、列表、表单、导航；②网络请求：dio 拦截器、JSON 解析；③状态管理：Provider/Riverpod；④平台调用：相机、定位、文件；⑤动画：Hero/自定义/隐式动画。

总结：资源包含 Flutter 官方 samples 仓库精选示例、跨平台 UI 组件库、状态管理模板、性能优化指南。源码程序直接 flutter pub get 即可运行。