跳到主要内容

omit_obvious_property_types

实验性
功能可用修复

对于顶层和静态变量,省略显而易见的类型注解。

详情

#

当类型显而易见时,不要为已初始化的顶层或静态变量添加类型注解。

错误示例

dart
final int myTopLevelVariable = 7;

class A {
  static String myStaticVariable = 'Hello';
}

正确示例

dart
final myTopLevelVariable = 7;

class A {
  static myStaticVariable = 'Hello';
}

有时,推断的类型可能不是您希望变量拥有的类型。例如,您可能打算稍后分配其他类型的值。您可能还希望显式编写类型注解,因为初始化表达式的类型不明显,并且记录此类型对于代码的未来读者将很有帮助。或者,您可能希望提交到特定类型,以便将来依赖项的更新(在附近的代码、导入中、任何地方)不会静默更改该变量的类型,从而在使用此变量的位置引入编译时错误或运行时错误。在这些情况下,请继续使用您想要的类型注解变量。

正确示例

dart
final num myTopLevelVariable = 7;

class A {
  static String? myStaticVariable = 'Hello';
}

此规则是实验性的。 它正在评估中,可能会被更改或删除。欢迎提供关于其行为的反馈!主要问题在这里:https://github.com/dart-lang/sdk/issues/59550。

不兼容的规则

#

`omit_obvious_property_types` 规则与以下规则不兼容

启用

#

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

analysis_options.yaml
yaml
linter:
  rules:
    - omit_obvious_property_types

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

analysis_options.yaml
yaml
linter:
  rules:
    omit_obvious_property_types: true