avoid_void_async

避免返回 void 的 async 函数。

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

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

错误示例

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

正确示例

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

例外情况

顶层 main 函数是一个例外，在顶层 main 函数中，可以（通常也应该）删除 Future 注解而使用 void。

正确示例

Future<void> f() async {}

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

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

linter:
  rules:
    - avoid_void_async

如果您改为使用 YAML 映射语法来配置 linter 规则，请在 linter > rules 下添加 avoid_void_async: true

linter:
  rules:
    avoid_void_async: true

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