跳到主要内容
目录

iterable_contains_unrelated_type

目录
已移除

使用不相关类型的引用调用 Iterable<E>.contains。

详情

#

注意：此规则已在 Dart 3.3.0 中移除；它不再起作用。

不要在 Iterable 上使用与参数类型不同的类型的实例调用 contains。

这样做将在其元素上调用 ==，并且很可能返回 false。

错误示例

dart
void someFunction() {
  var list = <int>[];
  if (list.contains('1')) print('someFunction'); // LINT
}

错误示例

dart
void someFunction3() {
  List<int> list = <int>[];
  if (list.contains('1')) print('someFunction3'); // LINT
}

错误示例

dart
void someFunction8() {
  List<DerivedClass2> list = <DerivedClass2>[];
  DerivedClass3 instance;
  if (list.contains(instance)) print('someFunction8'); // LINT
}

错误示例

dart
abstract class SomeIterable<E> implements Iterable<E> {}

abstract class MyClass implements SomeIterable<int> {
  bool badMethod(String thing) => this.contains(thing); // LINT
}

正确示例

dart
void someFunction10() {
  var list = [];
  if (list.contains(1)) print('someFunction10'); // OK
}

正确示例

dart
void someFunction1() {
  var list = <int>[];
  if (list.contains(1)) print('someFunction1'); // OK
}

正确示例

dart
void someFunction4() {
  List<int> list = <int>[];
  if (list.contains(1)) print('someFunction4'); // OK
}

正确示例

dart
void someFunction5() {
  List<ClassBase> list = <ClassBase>[];
  DerivedClass1 instance;
  if (list.contains(instance)) print('someFunction5'); // OK
}

abstract class ClassBase {}

class DerivedClass1 extends ClassBase {}

正确示例

dart
void someFunction6() {
  List<Mixin> list = <Mixin>[];
  DerivedClass2 instance;
  if (list.contains(instance)) print('someFunction6'); // OK
}

abstract class ClassBase {}

abstract class Mixin {}

class DerivedClass2 extends ClassBase with Mixin {}

正确示例

dart
void someFunction7() {
  List<Mixin> list = <Mixin>[];
  DerivedClass3 instance;
  if (list.contains(instance)) print('someFunction7'); // OK
}

abstract class ClassBase {}

abstract class Mixin {}

class DerivedClass3 extends ClassBase implements Mixin {}

启用

#

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

analysis_options.yaml
yaml
linter:
  rules:
    - iterable_contains_unrelated_type

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

analysis_options.yaml
yaml
linter:
  rules:
    iterable_contains_unrelated_type: true

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