Flutter将Navigator路由拆分到独立文件时找不到RouteSettings生成器如何解决

你遇到的报错核心原因是路由表没有正确注册到应用顶层唯一的MaterialApp中，或存在多个互相独立的MaterialApp实例导致路由上下文不匹配，按照以下步骤调整即可：

步骤1：调整routes.dart结构，单独抽离路由配置 #

不要将启动逻辑和路由配置耦合，将路由名称、路由表单独抽成可复用的常量：

import 'package:flutter/material.dart';
import 'widgets/login.dart';
import 'widgets/homepage.dart';

// 统一管理路由名称，避免手写字符串拼写错误
class RouteNames {
  static const String login = '/';
  static const String homePage = '/homepage';
}

// 全局路由表常量，可直接给MaterialApp的routes参数使用
final Map<String, WidgetBuilder> appRoutes = {
  RouteNames.login: (context) => Login(),
  RouteNames.homePage: (context) => HomePage(),
};

步骤2：修改main.dart，引入抽离的路由表 #

删除你之前在routes.dart里写的main函数和Nav2App类，统一在main.dart中配置顶层MaterialApp，引入抽离的路由表：

import 'package:flutter/material.dart';
import 'routes.dart';

void main() {
  runApp(const MyApp());
}

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

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      debugShowCheckedModeBanner: false,
      title: 'Flutter Login Demo',
      theme: ThemeData(
        primarySwatch: Colors.blue,
      ),
      // 注意：不要同时配置home参数和routes里的'/'路由，二者选其一即可
      initialRoute: RouteNames.login,
      // 直接使用抽离的路由表
      routes: appRoutes,
    );
  }
}

步骤3：修改跳转逻辑，避免拼写错误 #

login.dart中的跳转可以直接使用RouteNames中定义的常量，减少手写错误：

child: TextButton(
  style: ButtonStyle(
    // 原有样式配置
  ),
  child: const Text('Login'),
  onPressed: () {
    Navigator.pushNamed(
      context,
      RouteNames.homePage,
    );
  },
),

注意事项 #

• 整个Flutter应用顶层仅需一个MaterialApp实例，嵌套多个MaterialApp会导致路由上下文隔离，找不到对应路由
• 如果需要实现带参数的路由，可以将onGenerateRoute配置也抽离到routes.dart中，扩展路由逻辑即可
• 不要在MaterialApp中同时配置home参数和routes中的/路由，否则home优先级更高，路由表会失效

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