跳到主要內容

prefer_final_fields

穩定
推薦
可自動修復

私有欄位可以為 final

詳情

#

摘自 Effective Dart

建議 將私有欄位宣告為 final,如果它們在庫中後面沒有被重新賦值。

儘可能將欄位宣告為 final 是一個好習慣,因為它有助於避免意外的重新賦值,並允許編譯器進行最佳化。

不良示例

dart
class BadImmutable {
  var _label = 'hola mundo! BadImmutable'; // LINT
  var label = 'hola mundo! BadImmutable'; // OK
}

不良示例

dart
class MultipleMutable {
  var _label = 'hola mundo! GoodMutable', _offender = 'mumble mumble!'; // LINT
  var _someOther; // LINT

  MultipleMutable() : _someOther = 5;

  MultipleMutable(this._someOther);

  void changeLabel() {
    _label= 'hello world! GoodMutable';
  }
}

良好示例

dart
class GoodImmutable {
  final label = 'hola mundo! BadImmutable', bla = 5; // OK
  final _label = 'hola mundo! BadImmutable', _bla = 5; // OK
}

良好示例

dart
class GoodMutable {
  var _label = 'hola mundo! GoodMutable';

  void changeLabel() {
    _label = 'hello world! GoodMutable';
  }
}

不良示例

dart
class AssignedInAllConstructors {
  var _label; // LINT
  AssignedInAllConstructors(this._label);
  AssignedInAllConstructors.withDefault() : _label = 'Hello';
}

良好示例

dart
class NotAssignedInAllConstructors {
  var _label; // OK
  NotAssignedInAllConstructors();
  NotAssignedInAllConstructors.withDefault() : _label = 'Hello';
}

啟用

#

要啟用 prefer_final_fields 規則,請在你的 analysis_options.yaml 檔案中,將 prefer_final_fields 新增到 linter > rules

analysis_options.yaml
yaml
linter:
  rules:
    - prefer_final_fields

如果你使用 YAML 對映語法配置 Linter 規則,請在 linter > rules 下新增 prefer_final_fields: true

analysis_options.yaml
yaml
linter:
  rules:
    prefer_final_fields: true