欢迎关注微信公众号：FSA全栈行动 👋
一、什么是 typedef？
在 Dart 开发中，如果你遇到那种嵌套了好几层的复杂类型，或者频繁出现的函数签名，代码写起来会非常痛苦。
举个最直观的例子，假设我们要写一个获取数据的回调函数：
Dart
// 不使用 typedef，每次都要写这么长
void fetchData(Future<String> Function(int, bool) callback) {
// ...
}每次写 fetchData 的地方都要重复这坨 Future<String> Function(int, bool)，不仅难看，以后如果回调的参数变了，我得满大街去找哪里写了这串签名。
如果用上 typedef，事情就变得简单多了：
Dart
typedef DataLoader = Future<String> Function(int, bool);
void fetchData(DataLoader callback) {
// ...
}这里 DataLoader 就是一个类型别名。它本质上是给一个已有的类型起了个"外号"，让代码意图变得非常清晰：别人一看 DataLoader 就知道这是一个数据加载器，而不是在研究那一堆复杂的函数签名。
二、typedef 的全能玩法
早期的 Dart 版本里，typedef 基本上只能给函数类型起名字。但从 Dart 2.13 开始，它变得非常强大，几乎可以给任何类型起别名。
1、函数类型（最经典用法）
除了最基础的 callback，你还可以定义各种业务相关的函数类型。
Dart
// 定义一个日志记录器的类型
typedef Logger = void Function(String message);
void consoleLogger(String message) {
print(message);
}
void main() {
// 像使用普通类型一样使用它
Logger logger = consoleLogger;
logger("Hello, LinXunFeng!");
}甚至可以定义泛型 typedef，这在处理各种转换器时非常爽：
Dart
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：
Dart
typedef ScoreMap = Map<String, List<int>>;
ScoreMap scores = {
"Alice": [90, 95],
"Bob": [88],
};Record（记录类型）别名 在 Dart 3 引入 Record 之后，typedef 的价值进一步放大。如果你的函数返回一个复杂的 Record，用别名简直是救命：
Dart
// 之前：如果不定义别名，函数签名会长得吓人
// 之后：
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 就能一眼看穿：
Dart
typedef VoidCallback = void Function();这个报错通常是因为你在传回调时，不小心把函数执行的结果（void）传给了需要回调函数的参数。
错误示范：
Dart
void save() {
print("Saving...");
}
ElevatedButton(
onPressed: save(), // ❌ 错误！这里是调用了 save() 并返回了 void
);正确示范：
Dart
ElevatedButton(
onPressed: save, // ✅ 正确！直接传递函数名
);
// 或者使用匿名函数包裹
ElevatedButton(
onPressed: () {
save();
},
);三、实战中的避坑与对比
虽然 typedef 好用，但它并不是万能的，很多新手会把它和 extension 或 abstract class 搞混。
1、typedef vs 其他概念
我整理了一个对比表格，方便大家快速判断什么时候该用哪种方案：
| 维度 | typedef |
Extension (扩展方法) |
Abstract Class (抽象类) |
Extension Type |
|---|---|---|---|---|
| 核心本质 | 仅仅是起个别名 | 为现有类型增加行为 | 定义接口和实现规范 | 创建编译时的新类型 |
| 是否创建新类型 | 否 (底层类型不变) | 否 | 是 | 是 |
| 是否能持有状态 | 否 | 否 | 能 | 能 |
| 适用场景 | 简化复杂类型或函数签名 | 给现有类添加方法 | 定义复杂的业务逻辑/接口 | 需要类型安全且零开销的包装 |
2、容易踩的坑
误区一：以为 typedef 创建了新类型 这是一个非常典型的误区。如果你写了：
Dart
typedef UserId = int;
typedef ProductId = int;
UserId user = 5;
ProductId product = user; // ✅ 不会报错，因为它们本质都是 int对于编译器来说，UserId 和 int 是完全一样的。如果你需要严格区分 UserId 和 ProductId（比如防止把用户 ID 传给商品 ID），你应该使用 extension type。
误区二：过度使用，制造冗余 不要给那些一眼就能看懂的类型起别名。
Dart
// ❌ 没必要
typedef Number = int;
typedef MyString = String;
// ✅ 有意义
typedef JsonMap = Map<String, Object?>;最后
typedef 虽然只是一个很小的语言特性，但它确实能让代码的"含金量"提升不少。它不增加任何运行时的负担（运行时就是个简单的类型），却能显著提升代码的可读性和可维护性。
记住一句话：当你在写复杂的函数签名或嵌套泛型感到头大时，就是该用 typedef 的时候了。
如果文章对您有所帮助, 请不吝点击关注一下我的微信公众号：FSA全栈行动, 这将是对我最大的激励. 公众号不仅有Android技术, 还有iOS, Python等文章, 可能有你想要了解的技能知识点哦~