跳到主要內容
目錄

avoid_implementing_value_types

目錄
穩定

不要實作會覆寫 == 的類別。

詳細資訊

#

不要實作會覆寫 == 的類別。

== 運算子在契約上必須是等價關係；也就是說，對於所有物件 o1 和 o2，o1 == o2 和 o2 == o1 必須同時為真，或同時為假。

注意：Dart 沒有真正的值類型，因此我們將實作 == 的類別視為識別值類型的代理。

當使用 implements 時，您不會繼承 == 的方法主體，這使得幾乎不可能遵循 == 的契約。覆寫 == 的類別通常可以直接在測試中使用，而無需建立 mock 或 fake。例如，對於給定的類別 Size

dart
class Size {
  final int inBytes;
  const Size(this.inBytes);

  @override
  bool operator ==(Object other) => other is Size && other.inBytes == inBytes;

  @override
  int get hashCode => inBytes.hashCode;
}

不良範例

dart
class CustomSize implements Size {
  final int inBytes;
  const CustomSize(this.inBytes);

  int get inKilobytes => inBytes ~/ 1000;
}

不良範例

dart
import 'package:test/test.dart';
import 'size.dart';

class FakeSize implements Size {
  int inBytes = 0;
}

void main() {
  test('should not throw on a size >1Kb', () {
    expect(() => someFunction(FakeSize()..inBytes = 1001), returnsNormally);
  });
}

良好範例

dart
class ExtendedSize extends Size {
  ExtendedSize(int inBytes) : super(inBytes);

  int get inKilobytes => inBytes ~/ 1000;
}

良好範例

dart
import 'package:test/test.dart';
import 'size.dart';

void main() {
  test('should not throw on a size >1Kb', () {
    expect(() => someFunction(Size(1001)), returnsNormally);
  });
}

啟用

#

若要啟用 avoid_implementing_value_types 規則，請在您的 analysis_options.yaml 檔案中的 linter > rules 下新增 avoid_implementing_value_types

analysis_options.yaml
yaml
linter:
  rules:
    - avoid_implementing_value_types

如果您改為使用 YAML map 語法來設定 linter 規則，請在 linter > rules 下新增 avoid_implementing_value_types: true

analysis_options.yaml
yaml
linter:
  rules:
    avoid_implementing_value_types: true

除非另有說明，否則本網站上的文件反映 Dart 3.7.1 版本。頁面最後更新於 2025-03-07。 檢視原始碼 或回報問題。