一、什么是 typedef？

在 Dart 开发中，如果你遇到那种嵌套了好几层的复杂类型，或者频繁出现的函数签名，代码写起来会非常痛苦。

举个最直观的例子，假设我们要写一个获取数据的回调函数：

// 不使用 typedef，每次都要写这么长
void fetchData(Future<String> Function(int, bool) callback) {
  // ...
}

每次写 fetchData 的地方都要重复这坨 Future<String> Function(int, bool)，不仅难看，以后如果回调的参数变了，我得满大街去找哪里写了这串签名。

如果用上 typedef，事情就变得简单多了：

typedef DataLoader = Future<String> Function(int, bool);

void fetchData(DataLoader callback) {
  // ...
}

这里 DataLoader 就是一个类型别名。它本质上是给一个已有的类型起了个“外号”，让代码意图变得非常清晰：别人一看 DataLoader 就知道这是一个数据加载器，而不是在研究那一堆复杂的函数签名。

二、typedef 的全能玩法

早期的 Dart 版本里，typedef 基本上只能给函数类型起名字。但从 Dart 2.13 开始，它变得非常强大，几乎可以给任何类型起别名。

1、函数类型（最经典用法）

除了最基础的 callback，你还可以定义各种业务相关的函数类型。

// 定义一个日志记录器的类型
typedef Logger = void Function(String message);

void consoleLogger(String message) {
  print(message);
}

void main() {
  // 像使用普通类型一样使用它
  Logger logger = consoleLogger;
  logger("Hello, LinXunFeng!");
}

甚至可以定义泛型 typedef，这在处理各种转换器时非常爽：

typedef Mapper<T> = T Function(String value);

int parseInt(String value) => int.parse(value);

void main() {
  Mapper<int> parser = parseInt;
  print(parser("123")); // 输出 7
}

2、通用类型（Dart 2.13+ 核心变化）

这是 typedef 最让我惊喜的进化。现在，它可以用来简化极其复杂的泛型集合或 Record 类型。

集合类型别名 与其写一坨 Map<String, List<int>>，不如直接定义一个 ScoreMap：

typedef ScoreMap = Map<String, List<int>>;

ScoreMap scores = {
  "Alice": [90, 95],
  "Bob": [88],
};

Record（记录类型）别名 在 Dart 3 引入 Record 之后，typedef 的价值进一步放大。如果你的函数返回一个复杂的 Record，用别名简直是救命：

// 之前：如果不定义别名，函数签名会长得吓人
// 之后：
typedef UserInfo = ({
  int id,
  String name,
  List<String> roles,
  bool active,
});

UserInfo fetchUser(String id) {
  return (
    id: 1,
    name: "Lin",
    roles: ["Admin"],
    active: true,
  );
}

3、Flutter 中的常见坑点

在 Flutter 开发中，我经常会遇到这种报错： The argument type 'void' can't be assigned to the parameter type 'VoidCallback?'.

很多人会懵：VoidCallback 到底是个啥？

其实通过 typedef 就能一眼看穿：

typedef VoidCallback = void Function();

这个报错通常是因为你在传回调时，不小心把函数执行的结果（void）传给了需要回调函数的参数。

错误示范：

void save() {
  print("Saving...");
}

ElevatedButton(
  onPressed: save(), // ❌ 错误！这里是调用了 save() 并返回了 void
);

正确示范：

ElevatedButton(
  onPressed: save, // ✅ 正确！直接传递函数名
);

// 或者使用匿名函数包裹
ElevatedButton(
  onPressed: () {
    save();
  },
);

三、实战中的避坑与对比

虽然 typedef 好用，但它并不是万能的，很多新手会把它和 extension 或 abstract class 搞混。

1、typedef vs 其他概念

我整理了一个对比表格，方便大家快速判断什么时候该用哪种方案：

维度	typedef	Extension (扩展方法)	Abstract Class (抽象类)	Extension Type
核心本质	仅仅是起个别名	为现有类型增加行为	定义接口和实现规范	创建编译时的新类型
是否创建新类型	否 (底层类型不变)	否	是	是
是否能持有状态	否	否	能	能
适用场景	简化复杂类型或函数签名	给现有类添加方法	定义复杂的业务逻辑/接口	需要类型安全且零开销的包装

2、容易踩的坑

误区一：以为 typedef 创建了新类型 这是一个非常典型的误区。如果你写了：

typedef UserId = int;
typedef ProductId = int;

UserId user = 5;
ProductId product = user; // ✅ 不会报错，因为它们本质都是 int

对于编译器来说，UserId 和 int 是完全一样的。如果你需要严格区分 UserId 和 ProductId（比如防止把用户 ID 传给商品 ID），你应该使用 extension type。

误区二：过度使用，制造冗余 不要给那些一眼就能看懂的类型起别名。

// ❌ 没必要
typedef Number = int;
typedef MyString = String;

// ✅ 有意义
typedef JsonMap = Map<String, Object?>;

最后

typedef 虽然只是一个很小的语言特性，但它确实能让代码的“含金量”提升不少。它不增加任何运行时的负担（运行时就是个简单的类型），却能显著提升代码的可读性和可维护性。

记住一句话：当你在写复杂的函数签名或嵌套泛型感到头大时，就是该用 typedef 的时候了。