跨平台开发 / 系统课时

理解 Future 与异步结果

理解 Future 与异步结果

Future 表示一个现在还拿不到、但稍后会完成的结果。理解它的关键不是记住几个方法名,而是分清“Future 对象已经返回”和“异步结果已经产生”是两件事,并能沿着结果链观察成功、失败与收尾阶段。

学习目标

  • 区分 Future 的未完成、成功完成和错误完成状态
  • 使用 then、catchError 与 whenComplete 观察并转换异步结果
  • 理解链式调用中值和错误如何传递到后续 Future

Future 不是立即值

调用一个返回 Future<int> 的函数时,调用点会立刻得到一个 Future 对象,而不是最终的 int。这个对象最初处于未完成状态,之后只能完成一次:要么携带一个值成功完成,要么携带一个错误和堆栈错误完成。

因此,不能把 Future<int> 当作 int 直接参与计算。真正的结果要通过回调链或后续的 await 取得。同步代码也不会因为创建了 Future 就自动停下来等待。

Future 从未完成到成功或错误完成,并继续进入结果链

用结果链观察完成过程

下面的程序先创建一个延迟完成的 Future,再依次处理成功值、主动制造错误、恢复错误,并执行统一收尾。main 中最后一行同步输出会先发生,这正好说明 Future 的结果不是立即值。

dart
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: 同步代码继续执行');
}

预期输出:

text
A: Future 即将创建
F: 同步代码继续执行
B: value=21
C: doubled=42
D: caught=StateError
E: chain complete

then 不只是“注册一个回调”,它还会返回新的 Future。回调返回普通值时,新 Future 以该值成功完成;回调返回另一个 Future 时,结果链会等待它完成;回调抛出异常时,新 Future 转为错误完成。

错误与收尾如何传播

catchError 会处理它之前这条链上尚未处理的错误。示例中的第二个 then 抛出 StateError,所以后续 catchError 被触发;它返回 -1 后,相当于把错误恢复成一个成功结果,链可以继续向后传播。

whenComplete 无论前面的 Future 成功还是失败都会执行,适合释放资源、结束计时或记录收尾日志。它通常不改变原结果,但如果 whenComplete 自己抛错,或返回一个错误完成的 Future,这个新错误会影响最终结果,因此收尾代码也要保持可靠。

判断一段 Future 代码时看什么

阅读 Future 链时,先逐段确认当前 Future 的结果类型,再看每个回调是返回普通值、返回 Future,还是可能抛错。只要沿着“这一段完成后产生了哪个新 Future”去追踪,就能判断后面的 then 或 catchError 为什么会执行。

当逻辑开始出现多层链式回调时,async 与 await 往往更容易阅读;但无论采用哪种写法,底层仍然是同一个规则:异步操作最终通过 Future 以值或错误完成。

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

目录与阅读设置

阅读设置

17

记录一个想法

理解 Future 与异步结果

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

登录哪都通