slash_for_doc_comments

Prefer using /// for doc comments.

This rule is available as of Dart 2.0.

Rule sets: recommended, flutter

This rule has a quick fix available.

From Effective Dart:

DO use /// for documentation comments.

Although Dart supports two syntaxes of doc comments (/// and /**), we prefer using /// for doc comments.

GOOD:

/// Parses a set of option strings. For each option:
///
/// * If it is `null`, then it is ignored.
/// * If it is a string, then [validate] is called on it.
/// * If it is any other type, it is *not* validated.
void parse(List options) {
  // ...
}

Within a doc comment, you can use markdown for formatting.

To enable the slash_for_doc_comments rule, add slash_for_doc_comments under linter > rules in your analysis_options.yaml file:

linter:
  rules:
    - slash_for_doc_comments

除非另有说明，文档之所提及适用于 Dart 3.5.4 版本，本页面最后更新时间: 2024-08-02。 查看文档源码 或者 报告页面问题。