跨平台开发 / 系统课时

认识 go_router 的声明式路由

认识 go_router 的声明式路由

本篇解决大型 Flutter 应用中路由配置分散的问题,介绍 go_router 如何通过声明式方式管理页面路径、参数和跳转逻辑,让导航结构更贴近应用状态和业务模型。

学习目标

  • 理解声明式路由与命名路由的核心区别。
  • 掌握 go_router 的基础路径配置和页面跳转。
  • 能够处理简单路径参数。

为什么需要声明式路由

传统命名路由主要描述“名称对应哪个页面”,而声明式路由描述“当前应用状态应该显示哪个页面”。这种方式更适合需要登录状态、深层链接、网页地址同步的应用。

go_router 是 Flutter 生态中常用的声明式路由方案,它通过统一的路由表管理路径、页面构建和参数解析。

配置基础路由

使用 go_router 时,需要创建 GoRouter 对象,并将它传递给 MaterialApp.router。

示例依赖 go_router 包后,可以这样配置:

yaml
# pubspec.yaml 片段示例
# 需要在 dependencies 中添加对应版本的 go_router
dart
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 或深层链接。
  • 页面展示依赖登录、权限等状态。

对于简单练习项目,命名路由已经足够;对于长期维护的商业应用,声明式路由通常更容易扩展。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

认识 go_router 的声明式路由

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通