Flutter如何用AlertDialog实现可顺序切换的onboarding新手引导界面

• 所有通过Navigator.push压入路由栈的AlertDialog本质都是独立路由，路由栈遵循“后进先出”的规则。连续压入多个指引弹窗路由后，执行pop操作会按栈顺序逐层销毁路由，当栈内所有弹窗被全部弹出后，pop操作会继续触发底层主页面路由的销毁，直接出现主页面被连带关闭、露出空白层级的问题。
• 按钮点击先跳转再弹窗无响应的问题，本质是跳转的新页面路由会被压在弹窗层下方，透明弹窗作为上层覆盖层挡住了下层页面，点击事件被弹窗拦截，实际跳转动作本身没有异常，只是弹窗没有同步销毁，视觉上看起来按钮毫无反应。

优先采用Overlay层实现（最适配新手引导场景） #

Overlay和主页面路由栈完全解耦，所有指引组件（黑色提示气泡、指向箭头、目标功能高亮蒙层）都直接挂载在应用根Overlay上，全程不调用主页面的Navigator方法，从根源上避免和路由栈的冲突：

• 提前将每一条指引的配置（对应功能的屏幕坐标、气泡文案、箭头朝向）整理成结构化列表，遍历列表依次展示
• 当前指引的OverlayEntry执行remove()销毁当前气泡后，立刻在同一帧内插入下一条指引的OverlayEntry，两个动作之间不残留空帧，完全不会出现背景闪烁
• 气泡从当前位置滑动到下一个目标位置的过渡加150ms的缓动动画，和箭头指向同步移动，实现流畅的指引切换效果

若坚持基于AlertDialog实现的最小修复 #

放弃“每一步指引都push一个独立弹窗路由、点击下一步就pop当前弹窗再push下一个”的逻辑，改成状态驱动的单弹窗结构：

• 在主页面内维护_currentGuideStep状态变量，所有指引内容都作为同一个AlertDialog内部的组件，通过状态更新切换不同的气泡内容、指向位置，全程只做一次弹窗的push操作
• “下一步”按钮的点击逻辑仅做两件事：将_currentGuideStep的值加1，当到达最后一步时再执行一次Navigator.pop()关闭整个弹窗，绝对不要在每一步切换时执行pop/push操作，从流程上杜绝路由栈混乱的问题

补充说明：即便为每个弹窗传入独立命名的context，只要弹窗是通过Navigator.push压入路由栈的，pop操作触发的栈销毁逻辑依然会按栈顺序依次执行，独立context并不会切断弹窗和主路由栈的关联，这也是之前传入独立context没有解决问题的核心原因。

内容的提问来源于stack exchange，提问作者juan jose perez hernandez