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