avoid_void_async

避免返回 void 的 async 函数。

此规则自 Dart 2.1 起可用。

此规则提供快速修复。

应该将 async 函数标记为返回 Future<void>。

当声明一个不返回值的方法或函数时，应声明它返回 Future<void> 而不是仅仅返回 void。

错误示例

dartvoid f() async {}
void f2() async => null;

正确示例

dartFuture<void> f() async {}
Future<void> f2() async => null;

例外

顶级的 main 函数是一个例外，其中 Future 注解可以（并且通常应该）被删除，转而使用 void。

正确示例

dartFuture<void> f() async {}

void main() async {
  await f();
}

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

analysis_options.yaml
yamllinter:
  rules:
    - avoid_void_async

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

详情