跳到主要内容

avoid_dynamic_calls

稳定

避免对 dynamic 目标进行方法调用或属性访问。

详情

#

建议 避免对显式或隐式静态类型为 dynamic 的对象进行方法调用或属性访问。动态调用在每种运行时环境和编译器中的处理方式略有不同,但大多数生产模式(甚至某些开发模式)都与动态调用相关的编译尺寸和运行时性能开销。

此外,类型为 dynamic 的目标会禁用大多数静态分析,这意味着与正确进行静态类型检查的 Dart 代码相比,它更容易导致运行时 NoSuchMethodErrorTypeError

Object? 上存在的方法和属性除外:

  • a.hashCode
  • a.runtimeType
  • a.noSuchMethod(someInvocation)
  • a.toString()

... 这些成员在基于 web 的运行时中是动态调度的,但在基于 VM 的运行时中则不是。此外,它们非常常见,如果禁止使用 any.toString()any == true 等,将会非常不便。

请注意,尽管 Function 是一种类型,但其语义与 dynamic 几乎相同,并且对类型为 Function 的对象进行调用也会触发此 lint 规则。

允许在转换表达式(as dynamicas Function)上进行动态调用。

错误示例

dart
void explicitDynamicType(dynamic object) {
  print(object.foo());
}

void implicitDynamicType(object) {
  print(object.foo());
}

abstract class SomeWrapper {
  T doSomething<T>();
}

void inferredDynamicType(SomeWrapper wrapper) {
  var object = wrapper.doSomething();
  print(object.foo());
}

void callDynamic(dynamic function) {
  function();
}

void functionType(Function function) {
  function();
}

正确示例

dart
void explicitType(Fooable object) {
  object.foo();
}

void castedType(dynamic object) {
  (object as Fooable).foo();
}

abstract class SomeWrapper {
  T doSomething<T>();
}

void inferredType(SomeWrapper wrapper) {
  var object = wrapper.doSomething<Fooable>();
  object.foo();
}

void functionTypeWithParameters(Function() function) {
  function();
}

启用

#

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

analysis_options.yaml
yaml
linter:
  rules:
    - avoid_dynamic_calls

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

analysis_options.yaml
yaml
linter:
  rules:
    avoid_dynamic_calls: true