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 映射语法来配置 linter 规则，请在 linter > rules 下添加 prefer_asserts_with_message: true

linter:
  rules:
    prefer_asserts_with_message: true

除非另有说明，本网站上的文档反映了 Dart 3.7.1 版本。页面上次更新于 2025-03-07。 查看源代码 或 报告问题。