unnecessary_library_name

library 宣言でライブラリ名を使用しないでください。

この規則は Dart 3.4 以降で使用可能です。

ルールセット: 推奨、flutter

この規則には、クイックフィックスが利用可能です。

library 宣言でライブラリ名を使用しないでください。

ライブラリ名は不要です。

ライブラリはライブラリ宣言を必要としませんが、ライブラリのドキュメントとライブラリのメタデータを添付するために追加できます。これらの用途には、library; の宣言で十分です。

ライブラリ名の唯一の使用は、part ファイルが所有するライブラリを参照することですが、part ファイルは、ライブラリ名ではなく、文字列 URI を使用してライブラリファイルを参照することを推奨します。

ライブラリ名がライブラリ宣言に追加されると、名前の競合のリスクが生じます。同じプログラム内の 2 つのライブラリが同じライブラリ名を持つ場合、コンパイル時エラーになります。これを避けるために、ライブラリ名は、偶発的な名前の衝突を避けるためだけに、パッケージ名とパスを含む、長くなる傾向があります。そのため、このようなライブラリ名は読みにくく、ドキュメントとしても役に立ちません。

悪い例

/// This library has a long name.
library magnificator.src.helper.bananas;

library utils; // Not as verbose, but risks conflicts.

良い例

/// This library is awesome.
library;

part "apart.dart"; // contains: `part of "good_library.dart";`

unnecessary_library_name 規則を有効にするには、analysis_options.yaml ファイルの linter > rules の下に unnecessary_library_name を追加します

linter:
  rules:
    - unnecessary_library_name

特に明記されていない限り、このサイトのドキュメントは Dart 3.5.3 を反映しています。ページの最終更新日は 2024-07-03 です。ソースを表示 または 問題を報告する。