Linter 規則

宣告方法傳回類型。

將控制結構運算式與其陳述式分開。

將必要的具名參數放在最前面。

在沒有預設值的具名參數上指定 @required。

指定類型註解。

避免對 lib/ 中的檔案使用相對匯入。

註解覆寫的成員。

註解重新宣告的成員。

在不需要時避免使用 dynamic 進行註解。

避免使用 as。

避免在條件運算式中使用 bool 字面值。

避免沒有 on 子句的 catch。

請勿明確捕捉 Error 或實作它的類型。

避免定義僅包含靜態成員的類別。

避免 double 和 int 檢查。

避免在 dynamic 目標上進行方法呼叫或屬性存取。

避免在 else 子句中使用空白陳述式。

避免在未標示為 @immutable 的類別上多載運算子 == 和 hashCode。

透過轉換周圍的引號來避免跳脫內部引號。

避免在 const 類別中使用欄位初始設定式。

避免對參數宣告使用 final。

避免在 forEach 中使用函式字面值。

避免使用 'FutureOr' 作為結果的類型。

請勿實作覆寫 == 的類別。

請勿將變數明確初始化為 null。

避免 JavaScript 四捨五入的整數。

請勿在單行上宣告多個變數。

請勿在自訂 == 運算子中檢查 null。

避免位置布林參數。

避免在生產程式碼中呼叫 print。

避免私有類型定義函式。

避免多餘的引數值。

避免對 lib/ 中的檔案使用相對匯入。

請勿重新命名覆寫方法的參數。

避免 setter 的傳回類型。

避免從傳回類型為 bool、double、int 或 num 的成員傳回 null。

避免為 Future 傳回 null。

避免為 void 傳回 null。

避免僅為了啟用流暢介面而從方法傳回 this。

避免沒有 getter 的 setter。

避免遮蔽類型參數。

避免在運算式陳述式中使用單一串聯。

避免速度緩慢的非同步 dart:io 方法。

避免在生產程式碼中使用.toString()，因為結果可能會被最小化。

避免使用類型作為參數名稱。

避免為函式運算式參數註解類型。

避免不必要的容器。

避免覆寫 final 欄位以在多次呼叫時傳回不同的值。

避免在建構子中定義未使用的參數。

避免傳回 void 的 async 函式。

避免在 Flutter Web 外掛程式套件外部使用僅限 Web 的函式庫。

僅等候 futures。

使用 UpperCamelCase 命名擴充功能。

使用 UpperCamelCase 命名類型。

取消 dart:async StreamSubscription 的執行個體。

在相同的參考上串聯連續的方法調用。

請勿將可為 null 的值轉換為不可為 null 的類型。

關閉 dart:core Sink 的執行個體。

使用不相關類型的引數調用各種集合方法。

依字母順序排序組合器名稱。

僅在文件註解中參考範圍內的識別項。

遺失條件式匯入。

偏好對常數名稱使用 lowerCamelCase。

避免在 finally 區塊中使用控制流程。

針對所有流程控制結構「務必」使用大括號。

將函式庫文件註解附加至函式庫指示詞。

相依於參考的套件。

遺失 deprecated 註解。

避免從宣告已淘汰元素的套件內使用這些元素。

「務必」在偵錯方法中參考所有公用屬性。

遵守 Effective Dart Guide 指示詞排序慣例。

請勿在非 async 區塊中調用非同步函式。

請勿使用環境宣告的變數。

為忽略註解加上文件。

避免空白 catch 區塊。

針對空白建構子主體使用 ; 而非 {}。

避免空白陳述式。

「務必」使用健全的 Null 安全性。

在檔案結尾放置單一換行符號。

為類別 enum-like 中的所有常數定義 case 子句。

使用 lowercase_with_underscores 命名原始碼檔案。

使用 Flutter TODO 格式：// TODO(使用者名稱)：訊息，https://URL-to-issue。

如果覆寫 ==，則一律覆寫 hashCode。

請勿從另一個套件匯入實作檔案。

在將物件當作函式使用時，明確提取 call 方法。

請勿隱含地重新開啟類別。

使用在 Dart 3.0 中有效的 case 運算式。

避免對 JS 互通性類型進行執行階段類型測試，因為結果可能與平台不一致。

條件不應無條件評估為 true 或 false。

使用不相關類型的參考調用 Iterable<E>.contains。

盡可能將 return 陳述式與指派結合。

以換行符號開始多行字串。

將函式庫註解附加至函式庫指示詞。

使用 lowercase_with_underscores 命名函式庫。

在指定函式庫前置字元時使用 lowercase_with_underscores。

避免在公用 API 中使用私有類型。

避免行長度超過 80 個字元。

使用不相關類型的參考調用 remove。

僅由字面值組成的布林運算式。

使用相符的 super 參數名稱。

程式碼區塊遺失指定的語言。

相鄰字串之間遺失空格。

請勿在清單中使用相鄰字串。

沒有預設 case。

請勿使用多個具有相同值的 case。

避免函式庫前置字元使用開頭底線。

避免本機識別項使用開頭底線。

請勿將布林運算式與布林字面值進行比較。

請勿在 createState 中放置任何邏輯。

避免在 runtimeType 上呼叫 toString()。

請勿將變數指派給自己。

請勿使用萬用字元參數或變數。

使用 lowerCamelCase 命名非常數識別項。

Noop 原始作業。

請勿在可能為 null 的類型參數上使用 null 檢查。

在預期使用閉包的位置，請勿傳遞 null 作為引數。

省略本機變數的類型註解。

省略本機變數的明顯類型註解。

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

當簡單函式即可完成時，避免定義單一成員抽象類別。

僅擲回擴充 Exception 或 Error 的類別執行個體。

請勿覆寫欄位。

為所有公用 API 提供文件註解。

對套件名稱使用 lowercase_with_underscores。

使用套件名稱和點分隔路徑作為函式庫名稱的前置字元。

請勿重新指派函式或方法的參數參考。

使用相鄰字串來串連字串字面值。

偏好將 asserts 放在初始設定式清單中。

偏好使用含訊息的 asserts。

偏好使用布林值作為 assert 條件。

盡可能使用集合字面值。

偏好使用 ??= 而非測試 null。

偏好對常數建構子使用 const。

偏好在 @immutable 類別上宣告 const 建構子。

針對宣告，偏好使用 const 而非 final。

偏好使用 const 字面值作為 @immutable 類別上建構子的參數。

偏好定義建構子而非靜態方法來建立執行個體。

針對 List 和 String 執行個體使用 contains。

在不需要跳脫序列的情況下，偏好使用雙引號。

使用 = 將具名參數與其預設值分開。

針對主體為單一 return 陳述式的簡短成員，使用 =>。

私有欄位可以是 final。

如果未重新指派參考，則偏好在 for-each 迴圈變數中使用 final。

如果未重新指派變數宣告，則偏好使用 final。

如果未重新指派參數宣告，則偏好使用 final。

從可迭代物件建置 map 時，偏好使用 for 元素。

僅將函式套用至所有元素時，使用 forEach。

使用函式宣告將函式繫結至名稱。

偏好泛型函式類型別名。

盡可能偏好使用 if 元素而非條件運算式。

偏好使用 ?? 運算子。

盡可能使用初始設定形式參數。

盡可能內嵌清單項目宣告。

偏好使用整數字面值而非雙精準度字面值。

使用插值來組合字串和值。

針對 Iterable 和 Map 使用 isEmpty。

針對 Iterable 和 Map 使用 isNotEmpty。

偏好使用 is! 運算子。

偏好在可迭代物件上使用 whereType。

偏好使用 mixin。

偏好使用 Null 感知方法呼叫。

偏好使用 Null 感知運算子。

針對 lib/ 中的檔案，偏好使用相對匯入。

僅針對包含單引號的字串使用雙引號。

盡可能使用擴展集合。

偏好為未初始化的變數和欄位輸入類型。

除非您確定不想要 void，否則請勿使用 Null 類型。

透過 @Deprecated("message") 提供淘汰訊息。

為所有公用成員加上文件。

屬性 getter 遞迴傳回自身。

針對所有參數清單和引數清單使用結尾逗號。

在 pubspec.yaml 中使用安全網址。

用於空格的 SizedBox。

使用 SizedBox shrink 和 expand 具名建構子。

偏好使用 /// 作為文件註解。

在小工具執行個體建立中，將子屬性排序在最後。

將建構子宣告排序在其他成員之前。

依字母順序排序 pub 相依性。

將未命名的建構子宣告排序在最前面。

為不明顯的本機變數類型指定類型註解。

為不明顯的最上層和靜態變數類型指定類型註解。

指定類型註解。

將 super 呼叫放在建構子初始設定清單的最後面。

測試 operator ==(Object other) 中引數的類型。

避免在 finally 區塊中使用 throw。

強化初始化形式參數的型別。

為公開 API 加上型別註解。

不要為初始化形式參數加上型別註解。

請勿將常數模式與型別字面值一起使用。

async 函式主體中的 Future 結果必須使用 await 等待，或使用 dart:async 標記為 unawaited。

在文件註解中使用角括號會被 Markdown 當作 HTML 處理。

沒有 await 就沒有 async。

在 return 中不必要的 await 關鍵字。

避免在不需要時於插值中使用大括號。

當 break 是隱含的時候，請勿使用明確的 break。

避免使用 const 關鍵字。

不必要的 .new 建構子名稱。

請勿對區域變數使用 final。

避免為了「安全」而將欄位包裝在 getter 和 setter 中。

請勿忽略未產生的診斷碼。

當 tear-off 可以做到時，請勿建立 lambda。

當不需要時，請勿指定 late 修飾詞。

除非程式庫指令具有文件註解或註解，否則請避免使用。

請勿在 library 宣告中包含程式庫名稱。

不必要的 new 關鍵字。

在可空感知賦值中避免使用 null。

在可空型別擴充功能上不必要的可空感知運算子。

不必要的 null 檢查。

避免在 ?? 運算子中使用 null。

為以非可為 null 值初始化的 final 變數使用非可為 null 型別。

請勿覆寫方法以使用相同的參數執行 super 方法調用。

可以移除不必要的括號。

不必要的原始字串。

避免使用不必要的陳述式。

移除字串中不必要的反斜線。

不必要的字串插值。

除非為了避免遮蔽，否則請勿使用 this 存取成員。

展開運算子中不必要的 toList()。

可以移除不必要的底線。

可執行程式庫中無法存取的最上層成員。

使用不相關型別的參考調用相等運算子 ==。

避免使用不安全的 HTML API。

不安全的型別：在非協變位置中有型別變數。

請勿跨非同步間隙使用 BuildContext。

使用 ColoredBox。

使用 DecoratedBox。

使用列舉，而不是行為類似列舉的類別。

偏好使用 8 位數十六進位整數 (例如，0xFFFFFFFF) 來實例化 Color。

為參數使用泛型函數型別語法。

使用 ?? 運算子將 null 轉換為 bool。

偏好使用 intValue.isOdd/isEven 而不是檢查 % 2 的結果。

在 widget 建構子中使用 key。

對於具有非可空型別的私有成員，請使用 late。

使用預定義的具名常數。

使用原始字串以避免跳脫字元。

使用 rethrow 重新拋出捕獲的例外。

對於概念上會變更屬性的操作，請使用 setter。

使用字串緩衝區來組合字串。

在 part of 指令中使用字串。

盡可能使用 super 初始化子參數。

使用 throwsA matcher 而不是 fail()。

如果適用，方法名稱請以 to/_to 或 as/_as 開頭。

使用截斷除法。

使用有效的正規表示式語法。

請勿賦值給 void。