内容

prefer_asserts_with_message

优先使用带消息的断言。

此规则从 Dart 2.3 开始可用。

详情

#

当断言失败时,并不总是很容易理解原因。在 assert 中添加消息可以帮助开发人员理解 AssertionError 发生的原因。

错误

dart
f(a) {
  assert(a != null);
}

class A {
  A(a) : assert(a != null);
}

正确

dart
f(a) {
  assert(a != null, 'a must not be null');
}

class A {
  A(a) : assert(a != null, 'a must not be null');
}

用法

#

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

analysis_options.yaml
yaml
linter:
  rules:
    - prefer_asserts_with_message