内容

avoid_equals_and_hash_code_on_mutable_classes

避免在未标记为 @immutable 的类上重载运算符 == 和 hashCode。

此规则自 Dart 2.6 开始可用。

详细信息

#

来自 Effective Dart

避免在未标记为 @immutable 的类上重载运算符 == 和 hashCode。

如果类不是不可变的,那么在集合中使用时,重载 operator ==hashCode 会导致不可预测和不希望有的行为。

错误

dart
class B {
  String key;
  const B(this.key);
  @override
  operator ==(other) => other is B && other.key == key;
  @override
  int get hashCode => key.hashCode;
}

正确

dart
@immutable
class A {
  final String key;
  const A(this.key);
  @override
  operator ==(other) => other is A && other.key == key;
  @override
  int get hashCode => key.hashCode;
}

注意:lint 检查 @immutable 注解的使用,即使类在其他情况下不可变,也会触发。因此

错误

dart
class C {
  final String key;
  const C(this.key);
  @override
  operator ==(other) => other is C && other.key == key;
  @override
  int get hashCode => key.hashCode;
}

用法

#

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

analysis_options.yaml
yaml
linter:
  rules:
    - avoid_equals_and_hash_code_on_mutable_classes