unawaited_futures

async 函数体中的 Future 结果必须使用 dart:async 进行 await 或标记为 unawaited。

此规则自 Dart 2.0 起可用。

此规则提供快速修复。

应该在 async 函数体内部等待返回 Future 的函数。

在 async 方法中很容易忘记 await，因为命名约定通常不会告诉我们方法是同步的还是异步的（除了 dart:io 中的一些）。

当您确实想要启动一个“即发即弃”的 Future 时，推荐的方法是使用 dart:async 中的 unawaited。 // ignore 和 // ignore_for_file 注释也有效。

错误

dartvoid main() async {
  doSomething(); // Likely a bug.
}

正确

dartFuture doSomething() => ...;

void main() async {
  await doSomething();

  unawaited(doSomething()); // Explicitly-ignored fire-and-forget.
}

要启用 unawaited_futures 规则，请在您的 analysis_options.yaml 文件中的 linter > rules 下添加 unawaited_futures

analysis_options.yaml
yamllinter:
  rules:
    - unawaited_futures

除非另有说明，否则本网站上的文档反映的是 Dart 3.6.0。页面最后更新于 2024-07-03。查看源代码或报告问题。

详情