在 Flutter 中，onGenerateRoute是一个用于动态生成路由的回调函数，通常在MaterialApp或CupertinoApp中配置。它会在以下两种情况下被调用：
- 使用
Navigator.pushNamed(context, routeName, arguments: ...)跳转时，路由名称未在routes字典中注册； - 需要根据路由名称和参数动态决定返回哪个页面（例如权限校验、按需加载等）。
作用
- 处理未注册的命名路由：作为“兜底”机制，避免因跳转不存在的路由而崩溃。
- 统一路由逻辑：可在一处集中处理路由参数、权限、埋点等逻辑。
- 支持深度链接（Deep Link）：尤其在 Web 或 App Link 场景下，可动态解析 URL 并映射到对应页面。
代码示例
MaterialApp( onGenerateRoute: (RouteSettings settings) { // 根据路由名称动态返回页面 switch (settings.name) { case '/': return MaterialPageRoute(builder: (_) => HomePage()); case '/detail': final args = settings.arguments as Map<String, dynamic>; return MaterialPageRoute( builder: (_) => DetailPage(id: args['id'], title: args['title']), ); default: return MaterialPageRoute(builder: (_) => NotFoundPage()); // 404 页面 } }, initialRoute: '/', );跳转时使用命名路由：
Navigator.pushNamed(context, '/detail', arguments: {'id': '123', 'title': '详情'});与routes和onUnknownRoute的关系
routes：预定义路由表，适用于静态、已知页面。onGenerateRoute：动态生成路由，优先级高于routes（若同时定义，onGenerateRoute会接管所有命名路由跳转）。onUnknownRoute：仅在onGenerateRoute也未处理该路由时调用（Flutter 官方文档建议不要同时使用onGenerateRoute和onUnknownRoute，以免逻辑冲突）。
注意：若定义了onGenerateRoute，则 routes将被忽略，所有命名路由跳转都会走onGenerateRoute回调 。
应用场景
- 权限控制：未登录时跳转到登录页。
- 参数校验：对传入的
arguments进行类型检查或默认值填充。 - 模块化路由管理：将路由逻辑抽离到独立文件（如
router.dart），提升代码可维护性 。 - Web 深度链接：使 URL 地址栏与页面路由同步 。
建议
- 优先使用
onGenerateRoute替代routes，尤其在中大型项目中，便于统一管理 - 避免同时设置
onUnknownRoute，防止逻辑重复或冲突 - 在
onGenerateRoute中始终返回有效的PageRoute，否则应用可能崩溃 - 可结合
ModalRoute.of(context)?.settings.arguments在目标页面接收参数
