跨平台开发 / 系统课时
认识 go_router 的声明式路由
认识 go_router 的声明式路由
本篇解决大型 Flutter 应用中路由配置分散的问题,介绍 go_router 如何通过声明式方式管理页面路径、参数和跳转逻辑,让导航结构更贴近应用状态和业务模型。
学习目标
- 理解声明式路由与命名路由的核心区别。
- 掌握 go_router 的基础路径配置和页面跳转。
- 能够处理简单路径参数。
为什么需要声明式路由
传统命名路由主要描述“名称对应哪个页面”,而声明式路由描述“当前应用状态应该显示哪个页面”。这种方式更适合需要登录状态、深层链接、网页地址同步的应用。
go_router 是 Flutter 生态中常用的声明式路由方案,它通过统一的路由表管理路径、页面构建和参数解析。
配置基础路由
使用 go_router 时,需要创建 GoRouter 对象,并将它传递给 MaterialApp.router。
示例依赖 go_router 包后,可以这样配置:
yaml
# pubspec.yaml 片段示例
# 需要在 dependencies 中添加对应版本的 go_routerdart
import 'package:flutter/material.dart';
import 'package:go_router/go_router.dart';
final router = GoRouter(
routes: [
GoRoute(
path: '/',
builder: (context, state) => const HomePage(),
),
GoRoute(
path: '/user/:id',
builder: (context, state) {
final id = state.pathParameters['id'];
return UserPage(userId: id ?? 'unknown');
},
),
],
);
void main() {
runApp(
MaterialApp.router(
routerConfig: router,
),
);
}
class HomePage extends StatelessWidget {
const HomePage({super.key});
@override
Widget build(BuildContext context) {
return Scaffold(
body: Center(
child: ElevatedButton(
onPressed: () {
context.go('/user/100');
},
child: const Text('查看用户'),
),
),
);
}
}
class UserPage extends StatelessWidget {
final String userId;
const UserPage({super.key, required this.userId});
@override
Widget build(BuildContext context) {
return Scaffold(
body: Center(child: Text('用户 ID: $userId')),
);
}
}预期输出
text
应用启动后显示首页。
点击“查看用户”后访问 /user/100。
UserPage 接收到路径参数 id,页面显示用户 ID: 100。理解路径参数和跳转方式
go_router 使用路径匹配规则处理 URL。例如 /user/:id 可以匹配多个用户页面,而不是为每个用户创建不同路由。
常见跳转方法包括:
| 方法 | 作用 |
|---|---|
context.go() |
替换当前路由状态,适合切换主要页面 |
context.push() |
保留当前页面并进入新页面,适合详情页 |
选择哪种方式取决于页面之间是否需要返回关系。
声明式路由适用场景
声明式路由更适合以下场景:
- 应用包含大量页面和嵌套路由。
- 需要支持 Web URL 或深层链接。
- 页面展示依赖登录、权限等状态。
对于简单练习项目,命名路由已经足够;对于长期维护的商业应用,声明式路由通常更容易扩展。
按自己的节奏,确认真正理解。