Flutter中如何管理屏幕实例数量？避免重复创建同一实例

核心思路 #

每次导航前先检查路由栈里有没有目标屏幕的实例：

• 有实例的话，直接弹出该实例之上的所有路由，回到已存在的屏幕
• 没有实例的话，再执行正常的命名路由跳转

具体实现代码 #

可以给NavigatorState写个扩展方法，方便全局调用：

extension NavigatorExtension on NavigatorState {
  Future<void> pushNamedSingleInstance(String routeName, {Object? arguments}) async {
    // 遍历路由栈，查找目标路由是否已存在
    final targetRoute = widget.route.children.firstWhere(
      (route) => route.settings.name == routeName,
      orElse: () => null,
    );

    if (targetRoute != null) {
      // 弹出目标路由之上的所有页面，回到已有实例
      popUntil((route) => route.settings.name == routeName);
    } else {
      // 不存在则正常跳转
      await pushNamed(routeName, arguments: arguments);
    }
  }
}

使用方式 #

把原来的pushNamed替换成这个扩展方法就行：

Navigator.of(context).pushNamedSingleInstance('/yourTargetRoute');

补充说明 #

• 如果是带动态参数的路由（比如/detail?id=123），要修改判断逻辑，除了路由名称，还要对比参数，避免把不同参数的同名称路由当成同一个实例
• 要是需要保留根路由（比如首页），可以调整popUntil的判断条件，防止误删根路由：

  popUntil((route) => route.settings.name == '/home' || route.settings.name == routeName);
  

内容的提问来源于stack exchange，提问作者Ibrahim Saleh