avoid_dynamic_calls
避免在 dynamic
目标上进行方法调用或属性访问。
详情
#应该 避免在显式或隐式静态类型为 dynamic
的对象上进行方法调用或访问属性。动态调用在每个运行时环境和编译器中的处理方式略有不同,但大多数生产模式(甚至某些开发模式)都存在与动态调用相关的编译大小和运行时性能损失。
此外,类型为 dynamic
的目标会禁用大多数静态分析,这意味着与正确进行静态类型化的 Dart 代码相比,它更容易导致运行时 NoSuchMethodError
或 TypeError
。
对于 Object?
上存在的方法和属性存在例外情况
a.hashCode
a.runtimeType
a.noSuchMethod(someInvocation)
a.toString()
... 这些成员在基于 Web 的运行时中是动态调度的,但在基于 VM 的运行时中则不是。此外,它们非常常见,以至于禁止例如 any.toString()
或 any == true
将会非常麻烦。
请注意,尽管 Function
是一种类型,但其语义与 dynamic
非常相似,并且对类型为 Function
的对象的调用也会触发此 lint。
在类型转换表达式(as dynamic
或 as Function
)上允许动态调用。
错误示例
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();
}
正确示例
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
linter:
rules:
- avoid_dynamic_calls
如果您改为使用 YAML 映射语法来配置 linter 规则,请在 linter > rules 下添加 avoid_dynamic_calls: true
linter:
rules:
avoid_dynamic_calls: true
除非另有说明,否则本网站上的文档反映的是 Dart 3.7.1 版本。页面上次更新于 2025-03-07。 查看源代码 或 报告问题。