Dart中typedef本质及Route相关Builder参数输入的技术疑问

兄弟我太懂这种“知其然不知其所以然”的感觉了——用typedef用了好久，但总觉得隔着一层窗户纸，不知道它到底是什么，也搞不清那些参数到底哪来的！今天就给你掰扯明白。

typedef其实就是函数类型的别名。你可以把它理解成给一种特定的“函数形状”（参数类型、数量、返回值类型）起个好记的名字，这样不用每次都写一长串函数签名，还能强制要求传入的函数必须符合这个形状。

举个简单的非Flutter例子：

typedef IntOperation = int Function(int a, int b);

这就定义了一个IntOperation类型，它代表所有“接受两个int参数，返回int的函数”。你可以写IntOperation add = (a,b) => a+b;，这样add就必须符合这个签名，编译器会帮你检查格式是否正确。

咱们拿你提到的这两个typedef具体拆解：

1. RoutePageBuilder #

Flutter里它的官方定义是：

typedef RoutePageBuilder = Widget Function(
  BuildContext context,
  Animation<double> animation,
  Animation<double> secondaryAnimation,
);

• 这个typedef的核心意思是：任何给pageBuilder传的函数，必须接受这三个参数，并且返回一个Widget。
• 那这些参数是哪来的？是Flutter的导航框架在执行路由切换（比如push/pop页面）的时候自动传入的：
  • context：当前路由的上下文，你可以用它获取主题、MediaQuery等全局信息
  • animation：当前页面的进入/退出动画对象，比如push新页面时，这个动画会从0过渡到1，你可以用它给页面加入场效果
  • secondaryAnimation：前一个页面的动画对象，比如push新页面时，旧页面可能会有退出动画，这个参数就是控制那个动画的

你写pageBuilder的时候，哪怕暂时用不到这些参数，也得保证函数签名匹配，比如：

// 基础写法，签名完全匹配
MaterialPageRoute(
  pageBuilder: (context, anim, secondaryAnim) => MyNewPage(),
);

// 如果想用到动画，比如给页面加淡入效果
MaterialPageRoute(
  pageBuilder: (context, anim, secondaryAnim) {
    return FadeTransition(
      opacity: anim,
      child: MyNewPage(),
    );
  },
);

2. RouteTransitionsBuilder #

它的官方定义是：

typedef RouteTransitionsBuilder = Widget Function(
  BuildContext context,
  Animation<double> animation,
  Animation<double> secondaryAnimation,
  Widget child,
);

• 比RoutePageBuilder多了一个child参数，这个child就是**pageBuilder返回的那个页面Widget**。
• transitionsBuilder的作用是给页面套上自定义过渡动画，比如滑动、缩放、旋转这些。同样，所有参数都是框架自动传入的：
  • child：就是你要加动画的页面本身
  • 另外三个参数的作用和RoutePageBuilder完全一致

比如自定义一个从右侧滑入的过渡效果：

MaterialPageRoute(
  pageBuilder: (context, anim, secondaryAnim) => MyNewPage(),
  transitionsBuilder: (context, anim, secondaryAnim, child) {
    return SlideTransition(
      position: Tween<Offset>(
        begin: Offset(1.0, 0.0),
        end: Offset.zero,
      ).animate(anim),
      child: child,
    );
  },
);

• typedef不是什么高深的东西，就是函数类型的“外号”，用来规范函数签名，让代码更清晰，也让编译器能帮你提前排查错误。
• 你给pageBuilder/transitionsBuilder传的函数，那些参数都是Flutter框架在路由切换的时机自动给你塞进去的，你不用手动传，只需要根据需求使用它们（比如做动画）或者直接忽略（如果不需要动画的话）。

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