Flutter设备返回键跳转首页实现求助（非导航栏返回键）

方案一：子页面单独用PopScope拦截处理 #

在个人资料等非首页页面，通过PopScope拦截返回键触发事件，手动导航回首页，同时阻止默认的页面弹出行为：

class ProfilePage extends StatelessWidget {
  const ProfilePage({super.key});

  @override
  Widget build(BuildContext context) {
    return PopScope(
      // 阻止默认的返回弹出行为
      canPop: false,
      onPopInvoked: (didPop) async {
        if (!didPop) {
          // 跳转到首页，保留首页在路由栈中
          Navigator.popUntil(
            context,
            ModalRoute.withName('/home'), // 替换为你的首页路由名称
          );
        }
      },
      child: Scaffold(
        appBar: AppBar(title: const Text('个人资料')),
        body: const Center(child: Text('个人资料页面')),
      ),
    );
  }
}

关键说明： #

• canPop: false 禁用系统默认的返回弹出逻辑，确保只有自定义回调生效
• onPopInvoked 是返回键触发时的回调，didPop 参数表示是否已执行默认弹出动作，仅在!didPop时处理自定义逻辑
• Navigator.popUntil 逐层弹出路由栈页面，直到匹配首页路由，确保最终回到首页

方案二：全局拦截返回键（无需每个页面单独处理） #

若要避免在每个子页面重复写拦截逻辑，可通过MaterialApp的builder参数全局包裹PopScope，统一处理返回键行为：

MaterialApp(
  initialRoute: '/home',
  routes: {
    '/home': (context) => const PopScope(
          canPop: false, // 首页单独禁用返回键
          child: HomePage(),
        ),
    '/profile': (context) => const ProfilePage(),
    // 其他路由...
  },
  builder: (context, child) {
    return PopScope(
      onPopInvoked: (didPop) async {
        if (!didPop) {
          final currentRouteName = ModalRoute.of(context)?.settings.name;
          // 仅当前页面非首页时，执行跳转首页逻辑
          if (currentRouteName != '/home') {
            Navigator.popUntil(
              context,
              ModalRoute.withName('/home'),
            );
          }
        }
      },
      child: child!,
    );
  },
)

关键说明： #

• 首页仍单独使用PopScope(canPop: false)，确保首页按下返回键无响应
• 全局PopScope对所有页面生效，通过判断当前路由名称，避免在首页执行跳转逻辑
• 该方式无需修改每个子页面代码，适合页面较多的场景

注意事项 #

1. 确保路由名称配置正确，ModalRoute.withName('/home')中的路由名称需与你定义的首页路由一致
2. 若使用Navigator.pushNamedAndRemoveUntil替代popUntil，会清空路由栈中除首页外的所有页面，可根据业务需求选择合适的导航方法
3. 测试时注意区分设备物理返回键和导航栏返回键（你已禁用导航栏返回键，无需额外处理）

内容的提问来源于stack exchange，提问作者rod-san