概述ModalRoute 是 Flutter 路由系统中的核心类它代表了一个模态路由。通过ModalRoute.of(context)我们可以在任何 Widget 中获取当前路由的设置信息包括路由参数。核心概念ModalRoute 是什么ModalRoute是 Flutter 路由系统的核心类它继承自Route类。每个路由页面都对应一个ModalRoute对象它包含了路由的所有信息包括settings路由设置包含路由名称和参数isCurrent是否是当前路由canPop是否可以弹出ModalRoute.of(context) 的原理ModalRoute.of(context)会沿着 Widget 树向上查找找到最近的ModalRoute对象。这个方法返回的是一个ModalRouteT?类型表示可能找到也可能找不到。一旦获取到ModalRoute对象我们就可以通过settings.arguments获取路由参数。代码实现基础示例方式一直接获取classProfilePageextendsStatelessWidget{constProfilePage({super.key});overrideWidgetbuild(BuildContextcontext){finalRouteSettingssettingsModalRoute.of(context)!.settings;finalargssettings.arguments;returnScaffold(appBar:AppBar(title:constText(用户资料)),body:Center(child:Text(参数: args.toString())),);}}在上面的代码中我们直接获取ModalRoute对象并通过settings.arguments获取参数。方式二安全获取带空检查classSafeProfilePageextendsStatelessWidget{constSafeProfilePage({super.key});overrideWidgetbuild(BuildContextcontext){finalmodalRouteModalRoute.of(context);if(modalRoute!nullmodalRoute.settings.arguments!null){finalMapString,dynamicargsmodalRoute.settings.argumentsasMapString,dynamic;returnScaffold(appBar:AppBar(title:constText(用户资料)),body:Center(child:Text(用户: args[userName])),);}returnconstScaffold(body:Center(child:Text(无参数)));}}在这个示例中我们添加了空安全检查确保在没有参数的情况下也能正常显示。方式三使用 extension 封装extensionRouteArgumentsonBuildContext{T?getArgumentsT(){returnModalRoute.of(this)?.settings.argumentsasT?;}}voiduseExtension(BuildContextcontext){finalargscontext.getArgumentsMapString,dynamic();}通过扩展方法我们可以更方便地获取路由参数。实际应用场景场景一在子 Widget 中获取参数有时我们需要在子 Widget 中获取路由参数而不仅仅是在页面根 Widget 中。classUserProfilePageextendsStatelessWidget{constUserProfilePage({super.key});overrideWidgetbuild(BuildContextcontext){returnScaffold(appBar:AppBar(title:constText(用户资料)),body:constUserInfoCard(),// 在子 Widget 中获取参数);}}classUserInfoCardextendsStatelessWidget{constUserInfoCard({super.key});overrideWidgetbuild(BuildContextcontext){// 在子 Widget 中获取路由参数finalMapString,dynamicargsModalRoute.of(context)!.settings.argumentsasMapString,dynamic;returnCard(child:Padding(padding:constEdgeInsets.all(16),child:Column(children:[Text(用户ID: args[userId]),Text(用户名: args[userName]),],),),);}}场景二动态获取参数有时我们需要在运行时动态获取参数例如在按钮点击事件中。classActionPageextendsStatelessWidget{constActionPage({super.key});overrideWidgetbuild(BuildContextcontext){returnScaffold(appBar:AppBar(title:constText(操作页面)),body:Center(child:ElevatedButton(onPressed:(){// 在事件处理中获取参数finalargsModalRoute.of(context)?.settings.arguments;if(args!null){print(参数: args.toString());}},child:constText(获取参数),),),);}}进阶用法使用泛型扩展通过泛型扩展我们可以更安全地获取特定类型的参数。extensionTypedRouteArgumentsonBuildContext{TgetArgsT(){finalargsModalRoute.of(this)?.settings.arguments;if(argsisT){returnargs;}throwArgumentError(Required argument of type$Tnot found);}T?getArgsOrNullT(){finalargsModalRoute.of(this)?.settings.arguments;returnargsisT?args:null;}}voiduseTypedExtension(BuildContextcontext){// 获取非空参数finaluserIdcontext.getArgsString();// 获取可空参数finaluserNamecontext.getArgsOrNullString();}结合 StatefulWidget 使用在 StatefulWidget 中我们可以在initState中获取参数并初始化状态。classProfilePageextendsStatefulWidget{constProfilePage({super.key});overrideStateProfilePagecreateState()_ProfilePageState();}class_ProfilePageStateextendsStateProfilePage{lateStringuserName;late int age;overridevoidinitState(){super.initState();// 在 initState 中获取参数finalargsModalRoute.of(context)?.settings.argumentsasMapString,dynamic;userNameargs[userName];ageargs[age];}overrideWidgetbuild(BuildContextcontext){returnScaffold(appBar:AppBar(title:Text(userName)),body:Column(children:[Text(用户名: userName),Text(年龄: age.toString()),],),);}}注意事项上下文有效性ModalRoute.of(context)需要一个有效的 BuildContext这个上下文必须是在路由树中的。// 正确使用路由内的上下文classMyPageextendsStatelessWidget{constMyPage({super.key});overrideWidgetbuild(BuildContextcontext){finalargsModalRoute.of(context)?.settings.arguments;// 有效returnContainer();}}// 错误使用路由外的上下文voidmain(){runApp(constMyApp());finalargsModalRoute.of(context)?.settings.arguments;// 无效}路由嵌套问题在嵌套路由中ModalRoute.of(context)会返回最内层的路由。// 嵌套路由场景Navigator.push(context,MaterialPageRoute(builder:(context)ParentPage(),));// ParentPage 中Navigator.push(context,MaterialPageRoute(builder:(context)ChildPage(),));// 在 ChildPage 中调用ModalRoute.of(context)// 返回 ChildPage 的路由参数获取时机ModalRoute.of(context)必须在 Widget 已经挂载到路由树之后调用。classMyPageextendsStatefulWidget{constMyPage({super.key});overrideStateMyPagecreateState()_MyPageState();}class_MyPageStateextendsStateMyPage{overridevoidinitState(){super.initState();// 可以在 initState 中获取参数finalargsModalRoute.of(context)?.settings.arguments;}overrideWidgetbuild(BuildContextcontext){// 也可以在 build 方法中获取参数finalargsModalRoute.of(context)?.settings.arguments;returnContainer();}}对比其他获取方式获取方式优点缺点适用场景ModalRoute.of(context)通用、灵活需要类型转换通用场景Widget 构造函数类型安全不支持命名路由简单页面extension 封装简洁、类型安全需要额外封装项目级封装总结ModalRoute 是获取路由参数的核心 API它提供了一种通用、灵活的方式来获取当前路由的设置信息。通过ModalRoute.of(context)我们可以在任何 Widget 中获取路由参数无论是在页面根 Widget 还是子 Widget 中。在实际开发中我们应该注意空安全ModalRoute.of(context)可能返回 null进行类型转换需要手动将参数转换为具体类型封装扩展方法通过 extension 提高代码可读性注意上下文有效性确保使用的是路由内的上下文掌握 ModalRoute 获取参数的方法是开发 Flutter 应用的必备技能之一。