在Dart中如何强制或提醒用户调用对象的dispose方法？

实现方案 #

Dart官方提供了专门的注解来实现这个需求，就是package:meta包中的@mustBeClosed注解，完全匹配你需要的「提醒使用者调用清理方法」的场景，和Sink.close的告警是同一套机制，并非Dart插件的特殊硬编码实现。

具体使用步骤 #

• 第一步：引入meta依赖
  普通Dart项目在pubspec.yaml中添加依赖：

  dependencies:
    meta: ^1.10.0
  

  Flutter项目默认已经内置了meta包，可以直接使用无需额外引入。
• 第二步：给需要释放资源的自定义类添加@mustBeClosed注解
  示例代码：

  import 'package:meta/meta.dart';
  
  @mustBeClosed
  class CustomResourceHolder {
    final _controller = StreamController();
  
    void dispose() {
      _controller.close();
      // 其他资源清理逻辑
    }
  }
  

  配置完成后，只要使用者创建了CustomResourceHolder的实例但没有调用dispose方法，IDE就会自动弹出对应的告警提示，和StreamController未调用close的告警完全一致。

可选增强方案 #

如果需要更明确的规范约束，可以先定义通用的释放接口，所有需要清理的类统一实现该接口：

abstract interface class Disposable {
  void dispose();
}

@mustBeClosed
class CustomResourceHolder implements Disposable {
  final _controller = StreamController();

  @override
  void dispose() {
    _controller.close();
  }
}

如果需要更强的约束，还可以在项目根目录的analysis_options.yaml中调整静态分析规则，将未调用释放方法的告警升级为编译错误：

linter:
  rules:
    close_sinks: true # 不仅针对Sink，也会触发@mustBeClosed注解的检查
analyzer:
  errors:
    close_sinks: error

补充说明 #

你之前找到的@mustCallSuper注解是用于子类重写方法的场景，要求子类重写对应方法时必须调用父类实现，和面向类使用者的提醒场景没有冲突，如果你希望子类重写dispose时必须调用父类的dispose，可以同时给dispose方法加上@mustCallSuper注解，两者可以配合使用。

内容的提问来源于stack exchange，提问作者Titan