unnecessary_library_name

在 library 宣告中不要有函式庫名稱。

請勿在 library 宣告中加入函式庫名稱。

函式庫名稱並非必要。

函式庫不需要函式庫宣告，但可以加入宣告以附加函式庫文件和函式庫 Metadata。宣告 library; 就足以應付這些用途。

函式庫名稱的唯一用途是讓 part 檔案回指其擁有的函式庫，但 part 檔案應優先使用字串 URI 回指函式庫檔案，而不是函式庫名稱。

如果將函式庫名稱加入函式庫宣告，就會產生名稱衝突的風險。如果同一個程式中的兩個函式庫具有相同的函式庫名稱，就會發生編譯時期錯誤。為了避免這種情況，函式庫名稱往往會很長，包含套件名稱和路徑，只是為了避免意外的名稱衝突。這使得這類函式庫名稱難以閱讀，甚至對文件撰寫也沒有用處。

不良範例

/// 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

如果您改為使用 YAML map 語法來設定 linter 規則，請在 linter > rules 下方加入 unnecessary_library_name: true

linter:
  rules:
    unnecessary_library_name: true

除非另有說明，否則本網站上的文件反映的是 Dart 3.7.1 版本。頁面最後更新於 2025-03-07。 檢視原始碼 或回報問題。