平时自己做独立开发和客户端交付时，每次新建 Flutter 工程，最耗精力的往往不是写业务页面，而是立项前两周反复折腾那套基建：
- 国内应用商店审核必卡的“点同意隐私政策前，严禁提前获取设备信息或初始化三方 SDK”；
- 多个请求同时 401 时，怎么用并发锁优雅地做 Token 无感刷新 而不触发重复刷新风暴；
- 底部导航栏多 Tab 切换时，怎么用
GoRouter保持各自独立的路由栈，并把启动页 -> 隐私弹窗 -> 首次引导页 -> 登录态拦截做成声明式自动守卫； - 还有 WebSocket 心跳与断线重连、亮/暗双主题持久化、骨架屏、毛玻璃组件……
为了省去每次新开项目从零搭架子的体力活，我把这套打磨好的工程底座整理开源了：Flutter Easy Starter。
🔗 项目地址
GitHub： https://github.com/reedtang666/flutter-easy-starter （ MIT 协议开源，如果刚好能帮你省下搭基建的时间，求顺手点个 Star ⭐ 支持一下！）
🛠️ 重点解决了哪些“脏活累活”？
- 国内应用市场隐私合规守卫（防审核被拒）
完整封装了
启动页 -> 隐私政策弹窗 -> 首次引导页 -> 登录检查 -> 首页的状态流转，严格保证在用户点击“同意隐私政策”之后，才去初始化设备信息与敏感 SDK 。 - Dio +
QueuedInterceptorsWrapperToken 无感续期 基于队列拦截器实现了并发锁无感刷新 Token ，多个请求同时过期时自动排队等待新 Token 并重放请求；刷新失败自动清理态并跳回登录页。 - GoRouter (
StatefulShellRoute) 路由守卫 底部多分支独立路由栈（切 Tab 不丢状态），支持 Deep Link ，并且把隐私同意态、首次引导态、登录态全部收敛在全局路由redirect守卫里，不用在业务代码里到处写Navigator.push判断。 - Riverpod (
Notifier) + 本地状态恢复 采用 Feature-first 的 Clean Architecture 分层结构，使用现代Notifier范式管理状态，配合本地持久化，冷启动自动恢复用户态与主题配置。 - WebSocket 实时通信底座 内置了带心跳检测、指数退避断线自动重连的 WebSocket 封装。
📱 不是只有 Counter 的空壳，直接内置了 14+ 预置页面
为了方便直接改造成社交、内容或工具类 App ，模板里用亮/暗双主题 + 毛玻璃（ Glassmorphism ）+ Shimmer 骨架屏预置了一套完整的页面：
- 前置流程：品牌动画启动页、支持 HTML 渲染的隐私合规弹窗、平滑指示器引导页、多方式登录页（密码/短信/微信 UI ）、资料完善与图片选择页
-
核心 Tab 与业务页：
- 介绍/导航中心页、带 Hero 动画的探索/旅游卡片页
- 消息列表（带 Story 故事环与侧滑操作）& 实时聊天界面
- 个人中心、VIP 订阅计划页、礼物商店（含购物车逻辑）、我的相册上传管理、帮助与反馈页
🚀 快速跑起来体验
环境要求 Flutter 3.0+ / Dart 3.0+，无需配置后端即可直接跑通完整 UI 与交互流：
git clone https://github.com/reedtang666/flutter-easy-starter.git
cd flutter-easy-starter
flutter pub get
flutter run
如果你正好准备用 Flutter 起一个新项目，或者想找一个结构清晰的 Riverpod + GoRouter + Dio 实战参考模板，欢迎直接拿去用，有任何问题或建议欢迎提 Issue 交流！
Select Language