HarmonyOS鸿蒙Next Flutter tips 如何获取当前路由

HarmonyOS鸿蒙Next Flutter tips 如何获取当前路由 Flutter 中的「路由」本质是 Route 对象，而「当前路由」通常指导航栈最顶层的页面路径 / 名称，获取方式分为「基于 Navigator 1.0（传统路由）」和「Navigator 2.0（路由框架）」两类，其中 Navigator 1.0 是最常用的场景。

一、基础方案：Navigator 1.0 获取当前路由（90% 场景适用）

1. 核心方法：通过 ModalRoute 获取（推荐）

ModalRoute 是 Flutter 内置的路由信息类，可直接在任意 BuildContext 中获取当前路由的名称、设置等信息，无需额外配置。

完整代码示例：

关键说明：

• Context 要求：必须使用「包含在 Navigator 中的 BuildContext」（如页面内的 context，不能用 MaterialApp 根 context）；
• 普通路由适配：如果使用 MaterialPageRoute 而非命名路由，需手动设置 settings: RouteSettings(name: '/detail')，否则 name 为 null；
• 参数获取：settings.arguments 可获取跳转时传递的参数，类型需自行强转。

2. 进阶：监听路由变化（全局获取）

如果需要全局监听路由变化（如埋点统计所有页面跳转），可通过 NavigatorObserver 实现：

二、进阶方案：Navigator 2.0 获取当前路由（路由框架）

如果你的项目使用了 Navigator 2.0（如 GoRouter、Router + RouteInformationParser），获取方式略有不同，以下以主流的 go_router 为例：

步骤 1：添加依赖

步骤 2：获取当前路由

关键说明：

• 1. GoRouterState.of(context)：获取当前路由的完整信息（uri 是核心，包含路径和参数）；
• 2. state.params：获取路由路径中的参数（如 /detail/:id 中的 id）；
• 3. state.queryParams：获取查询参数（如 /detail?id=123 中的 id）。

总结

1. 1. Navigator 1.0：优先使用 ModalRoute.of(context)?.settings 获取路由名称 / 参数，普通路由需手动设置 name；
2. 2. Navigator 2.0（GoRouter）：用 GoRouterState.of(context) 获取 uri/params，适配现代路由框架；
3. 3. 全局监听：通过 NavigatorObserver 监听路由跳转，实现埋点等全局逻辑；
4. 4. 核心避坑：确保使用「路由内的 Context」，避免根 Context 导致获取失败。