no_leading_underscores_for_local_identifiers

避免在 local 識別符號中使用前導底線。

此規則自 Dart 2.16 起可用。

規則集：建議、flutter

此規則有快速修復可用。

請勿在非私有的識別符號使用前導底線。Dart 在識別符號中使用前導底線來將成員和最上層宣告標記為私有。這會訓練使用者將前導底線與這些宣告種類之一相關聯。他們看到 _ 就會認為是「私有」。對於 local 變數或參數沒有「私有」的概念。當其中一個的名稱以底線開頭時，會向讀者發出令人困惑的訊號。為避免這種情況，請勿在這些名稱中使用前導底線。

例外狀況：：未使用的參數可以命名為 _、__、___ 等。這在回呼中很常見，在回呼中會傳遞一個值，但您不需要使用它。給它一個僅由底線組成的名稱，是表示該值未使用的慣用方式。

不良範例

void print(String _name) {
  var _size = _name.length;
  ...
}

良好範例

void print(String name) {
  var size = name.length;
  ...
}

確定

[1,2,3].map((_) => print('Hello'));

若要啟用 no_leading_underscores_for_local_identifiers 規則，請在您的 analysis_options.yaml 檔案中的 linter > rules 下新增 no_leading_underscores_for_local_identifiers。

linter:
  rules:
    - no_leading_underscores_for_local_identifiers

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