unnecessary_library_directive

Avoid library directives unless they have documentation comments or annotations.

DO use library directives if you want to document a library and/or annotate a library.

BAD:

library;

GOOD:

/// This library does important things
library;

@TestOn('js')
library;

NOTE: Due to limitations with this lint, libraries with parts will not be flagged for unnecessary library directives.

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

linter:
  rules:
    - unnecessary_library_directive

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

linter:
  rules:
    unnecessary_library_directive: true

Unless stated otherwise, the documentation on this site reflects Dart 3.6.0. Page last updated on 2025-01-27. View source or report an issue.