目錄

omit_obvious_property_types

省略頂層和靜態變數的明顯類型註解。

此規則目前為 實驗性,尚未在穩定的 SDK 中提供。

此規則具有可用的快速修正

不相容的規則:always_specify_types

詳細資訊

#

當類型明顯時,請勿為初始化的頂層或靜態變數加上類型註解。

不良

dart
final int myTopLevelVariable = 7;

class A {
  static String myStaticVariable = 'Hello';
}

良好

dart
final myTopLevelVariable = 7;

class A {
  static myStaticVariable = 'Hello';
}

有時推斷的類型並非您希望變數擁有的類型。例如,您可能打算稍後指派其他類型的值。您也可能希望明確撰寫類型註解,因為初始表達式的類型不明顯,並且對於未來閱讀程式碼的人來說記錄此類型會很有幫助。或者,您可能希望提交到特定類型,以便未來對相依性的更新(在附近的程式碼中、在匯入中、在任何地方)不會靜默地變更該變數的類型,從而在使用該變數的位置引入編譯時期錯誤或執行時期錯誤。在這些情況下,請繼續為變數加上您想要的類型註解。

良好

dart
final num myTopLevelVariable = 7;

class A {
  static String? myStaticVariable = 'Hello';
}

此規則為實驗性。正在評估中,可能會變更或移除。歡迎提供對其行為的回饋!主要問題在此:https://github.com/dart-lang/linter/issues/5101。

用法

#

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

analysis_options.yaml
yaml
linter:
  rules:
    - omit_obvious_property_types