dangling_library_doc_comments

Attach library doc comments to library directives.

Attach library doc comments (with ///) to library directives, rather than leaving them dangling near the top of a library.

BAD:

/// This is a great library.
import 'package:math';

/// This is a great library.

class C {}

GOOD:

/// This is a great library.
library;

import 'package:math';

class C {}

NOTE: An unnamed library, like library; above, is only supported in Dart 2.19 and later. Code which might run in earlier versions of Dart will need to provide a name in the library directive.

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

linter:
  rules:
    - dangling_library_doc_comments

If you're instead using the YAML map syntax to configure linter rules, add dangling_library_doc_comments: true under linter > rules:

linter:
  rules:
    dangling_library_doc_comments: true

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