跨平台开发 / 系统课时
理解 Future 与异步结果
理解 Future 与异步结果
Future 表示一个现在还拿不到、但稍后会完成的结果。理解它的关键不是记住几个方法名,而是分清“Future 对象已经返回”和“异步结果已经产生”是两件事,并能沿着结果链观察成功、失败与收尾阶段。
学习目标
- 区分
Future的未完成、成功完成和错误完成状态 - 使用
then、catchError与whenComplete观察并转换异步结果 - 理解链式调用中值和错误如何传递到后续
Future
Future 不是立即值
调用一个返回 Future<int> 的函数时,调用点会立刻得到一个 Future 对象,而不是最终的 int。这个对象最初处于未完成状态,之后只能完成一次:要么携带一个值成功完成,要么携带一个错误和堆栈错误完成。
因此,不能把 Future<int> 当作 int 直接参与计算。真正的结果要通过回调链或后续的 await 取得。同步代码也不会因为创建了 Future 就自动停下来等待。

用结果链观察完成过程
下面的程序先创建一个延迟完成的 Future,再依次处理成功值、主动制造错误、恢复错误,并执行统一收尾。main 中最后一行同步输出会先发生,这正好说明 Future 的结果不是立即值。
Future<int> loadNumber() {
return Future<int>.delayed(
const Duration(milliseconds: 50),
() => 21,
);
}
void main() {
print('A: Future 即将创建');
loadNumber()
.then<int>((value) {
print('B: value=$value');
return value * 2;
})
.then<int>((value) {
print('C: doubled=$value');
throw StateError('stop');
})
.catchError((Object error) {
print('D: caught=${error.runtimeType}');
return -1;
})
.whenComplete(() {
print('E: chain complete');
});
print('F: 同步代码继续执行');
}预期输出:
A: Future 即将创建
F: 同步代码继续执行
B: value=21
C: doubled=42
D: caught=StateError
E: chain completethen 不只是“注册一个回调”,它还会返回新的 Future。回调返回普通值时,新 Future 以该值成功完成;回调返回另一个 Future 时,结果链会等待它完成;回调抛出异常时,新 Future 转为错误完成。
错误与收尾如何传播
catchError 会处理它之前这条链上尚未处理的错误。示例中的第二个 then 抛出 StateError,所以后续 catchError 被触发;它返回 -1 后,相当于把错误恢复成一个成功结果,链可以继续向后传播。
whenComplete 无论前面的 Future 成功还是失败都会执行,适合释放资源、结束计时或记录收尾日志。它通常不改变原结果,但如果 whenComplete 自己抛错,或返回一个错误完成的 Future,这个新错误会影响最终结果,因此收尾代码也要保持可靠。
判断一段 Future 代码时看什么
阅读 Future 链时,先逐段确认当前 Future 的结果类型,再看每个回调是返回普通值、返回 Future,还是可能抛错。只要沿着“这一段完成后产生了哪个新 Future”去追踪,就能判断后面的 then 或 catchError 为什么会执行。
当逻辑开始出现多层链式回调时,async 与 await 往往更容易阅读;但无论采用哪种写法,底层仍然是同一个规则:异步操作最终通过 Future 以值或错误完成。