prefer_asserts_with_message

优先使用带消息的断言。

断言失败时，并不总是容易理解原因。在 assert 中添加消息有助于开发者理解 AssertionError 发生的原因。

不好的示例

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

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

好的示例

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 规则，请在你的 analysis_options.yaml 文件中的 linter > rules 下添加 prefer_asserts_with_message。

linter:
  rules:
    - prefer_asserts_with_message

如果你使用 YAML map 语法来配置 linter 规则，请在 linter > rules 下添加 prefer_asserts_with_message: true。

linter:
  rules:
    prefer_asserts_with_message: true