跳到主要內容
內容

prefer_final_parameters

內容
穩定版本
提供修正

如果參數宣告未重新賦值，則建議使用 final。

詳細資訊

#

建議 (DO) 在函式主體中未重新賦值時，將參數宣告為 final。

在可能的情況下將參數宣告為 final 是一個好習慣，因為這有助於避免意外的重新賦值。

不良範例

dart
void badParameter(String label) { // LINT
  print(label);
}

良好範例

dart
void goodParameter(final String label) { // OK
  print(label);
}

不良範例

dart
void badExpression(int value) => print(value); // LINT

良好範例

dart
void goodExpression(final int value) => print(value); // OK

不良範例

dart
[1, 4, 6, 8].forEach((value) => print(value + 2)); // LINT

良好範例

dart
[1, 4, 6, 8].forEach((final value) => print(value + 2)); // OK

良好範例

dart
void mutableParameter(String label) { // OK
  print(label);
  label = 'Hello Linter!';
  print(label);
}

不相容的規則

#

prefer_final_parameters 規則與下列規則不相容

啟用

#

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

analysis_options.yaml
yaml
linter:
  rules:
    - prefer_final_parameters

如果您改用 YAML map 語法來設定 linter 規則，請在 linter > rules 下新增 prefer_final_parameters: true

analysis_options.yaml
yaml
linter:
  rules:
    prefer_final_parameters: true

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