Flutter使用自定义PageRouteBuilder时如何从非命名路由迁移到命名路由

你可以通过 onGenerateRoute 回调统一处理命名路由的生成，完全复用现有 CustomPageRouteBuilder 的所有逻辑，不需要修改原有封装的路由类代码。

具体实现步骤 #

1. 定义路由名称常量（可选但推荐） #

避免硬编码路由字符串导致的拼写错误：

class RouteNames {
  static const home = '/home';
  static const userProfile = '/user_profile';
  static const settings = '/settings';
  // 补充所有业务页面的路由名
}

2. 建立路由名与页面的映射表 #

存储每个路由对应的页面构造逻辑，支持参数传递：

// 映射表结构：key为路由名，value为接收参数返回对应页面的方法
final Map<String, Widget Function(Object? arguments)> _routeMap = {
  RouteNames.home: (args) => const HomePage(),
  RouteNames.userProfile: (args) => UserProfilePage(userData: args as UserModel),
  RouteNames.settings: (args) => const SettingsPage(),
  // 所有需要跳转的页面都在此处注册
};

3. 配置MaterialApp的onGenerateRoute #

替换原有 routes 参数，在回调中直接复用你的自定义路由构造类：

MaterialApp(
  // 移除原来的routes配置，改用onGenerateRoute
  initialRoute: RouteNames.home,
  onGenerateRoute: (RouteSettings settings) {
    // 根据路由名从映射表取对应页面的构造方法
    final pageBuilder = _routeMap[settings.name];
    if (pageBuilder != null) {
      // 直接返回你的CustomPageRouteBuilder实例，原有过渡动画、生物认证、版本号逻辑全部保留
      return CustomPageRouteBuilder(
        builder: (context) => pageBuilder(settings.arguments),
        // 你原有CustomPageRouteBuilder的其他配置参数原样传入即可
      );
    }
    // 路由匹配不到的兜底逻辑，比如跳转到404页面
    return CustomPageRouteBuilder(
      builder: (context) => const NotFoundPage(),
    );
  },
)

跳转方式替换 #

原有直接传路由实例的跳转代码直接替换为命名路由调用即可：

// 无参数跳转
Navigator.pushNamed(context, RouteNames.settings);
// 带参数跳转
Navigator.pushNamed(context, RouteNames.userProfile, arguments: UserModel(name: '张三'));

扩展说明 #

如果部分页面需要特殊配置（比如跳过生物认证），你可以把映射表的value换成自定义配置类，增加needAuth、transitionDuration等属性，在onGenerateRoute中读取配置后传入CustomPageRouteBuilder即可灵活适配不同页面的路由需求。

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