在 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 MapString, 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在目标页面接收参数 ‌