跳到主要内容
目录

use_build_context_synchronously

目录
稳定版
Flutter

不要在异步间隙中使用 BuildContext。

详情

#

不要在异步间隙中使用 BuildContext。

存储 BuildContext 以供后续使用很容易导致难以诊断的崩溃。异步间隙隐式地存储了 BuildContext，并且在编写代码时最容易被忽视。

当使用 BuildContext 时，必须在异步间隙后检查 mounted 属性，具体取决于 BuildContext 的访问方式

  • 当使用 State 的 context 属性时，必须检查 State 的 mounted 属性。
  • 对于其他 BuildContext 实例（例如局部变量或函数参数），必须检查 BuildContext 的 mounted 属性。

错误示例

dart
void onButtonTapped(BuildContext context) async {
  await Future.delayed(const Duration(seconds: 1));
  Navigator.of(context).pop();
}

正确示例

dart
void onButtonTapped(BuildContext context) {
  Navigator.of(context).pop();
}

正确示例

dart
void onButtonTapped(BuildContext context) async {
  await Future.delayed(const Duration(seconds: 1));

  if (!context.mounted) return;
  Navigator.of(context).pop();
}

正确示例

dart
abstract class MyState extends State<MyWidget> {
  void foo() async {
    await Future.delayed(const Duration(seconds: 1));
    if (!mounted) return; // Checks `this.mounted`, not `context.mounted`.
    Navigator.of(context).pop();
  }
}

启用

#

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

analysis_options.yaml
yaml
linter:
  rules:
    - use_build_context_synchronously

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

analysis_options.yaml
yaml
linter:
  rules:
    use_build_context_synchronously: true

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