Linter 規則

宣告方法返回型別。

將控制結構表示式與其語句分開。

將必需的命名引數放在首位。

對沒有預設值的命名引數指定 @required。

指定型別註解。

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

註解被覆蓋的成員。

註解重新宣告的成員。

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

避免使用 as。

在條件表示式中避免使用 bool 字面量。

避免不帶 on 子句的捕獲塊。

不要顯式捕獲 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 的庫。

僅 await Future。

使用 UpperCamelCase 命名擴充套件。

使用 UpperCamelCase 命名型別。

取消 dart:async StreamSubscription 的例項。

對同一引用上的連續方法呼叫使用級聯。

不要將可空值轉換為不可空型別。

關閉 dart:core Sink 的例項。

使用不相關型別的引數呼叫各種集合方法。

按字母順序對組合器名稱進行排序。

僅在文件註釋中引用作用域內的識別符號。

缺少條件匯入。

常量名稱首選使用 lowerCamelCase。

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

對所有控制流結構都使用大括號。

將庫文件註釋附加到庫指令。

依賴引用的包。

缺少棄用註解。

避免在宣告它們的包中使用已棄用的元素。

在除錯方法中引用所有公共屬性。

遵守高效 Dart 指南的指令排序約定。

同步函式中不應有返回 Future 的呼叫，除非它們被賦值或返回。

不要使用環境宣告的變數。

文件忽略註釋。

避免空的 catch 塊。

對於空的建構函式體，使用 ; 而不是 {}。

避免空語句。

使用健全的空安全。

在檔案末尾放置一個換行符。

為類似列舉的類中的所有常量定義 case 子句。

使用 lowercase_with_underscores 命名原始檔。

使用 Flutter TODO 格式：// TODO(使用者名稱): 訊息, https://問題連結。

如果重寫 ==，則始終重寫 hashCode。

不要從另一個包匯入實現檔案。

將物件用作 Function 時，顯式分離 call 方法。

不要隱式地重新開啟類。

使用在 Dart 3.0 中有效的 case 表示式。

避免對 JS 互操作型別進行執行時型別測試，因為結果可能與平臺不一致。

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

使用不相關型別的引用呼叫 Iterable<E>.contains。

如果可能，將 return 語句與賦值合併。

多行字串以換行符開頭。

將庫註解附加到庫指令。

使用 lowercase_with_underscores 命名庫。

指定庫字首時使用 lowercase_with_underscores。

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

避免行長於 80 個字元。

使用不相關型別的引用呼叫 remove。

僅由字面量組成的布林表示式。

使用匹配的超引數名稱。

程式碼塊缺少指定的語言。

相鄰字串之間缺少空格。

不要在列表中使用相鄰字串。

沒有預設 case。

不要使用多個相同值的 case。

避免庫字首使用前導下劃線。

避免本地識別符號使用前導下劃線。

不要將布林表示式與布林字面量進行比較。

不要在 createState 中放置任何邏輯。

避免在 runtimeType 上呼叫 toString()。

不要將變數賦值給自己。

不要使用萬用字元引數或變數。

非常量識別符號使用 lowerCamelCase 命名。

無操作原始操作。

不要對可能為空的型別引數使用 null 檢查。

在期望閉包的地方，不要將 null 作為引數傳遞。

省略區域性變數的型別註解。

省略區域性變數的明顯型別註解。

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

當簡單函式可以完成任務時，避免定義單成員抽象類。

只丟擲擴充套件 Exception 或 Error 的類例項。

不要覆蓋欄位。

為所有公共 API 提供文件註釋。

包名使用 lowercase_with_underscores。

庫名稱字首為包名和點分隔路徑。

不要重新賦值函式或方法的引數引用。

使用相鄰字串連線字串字面量。

首選將斷言放在初始化列表中。

首選帶訊息的斷言。

首選使用布林值作為斷言條件。

儘可能使用集合字面量。

首選使用 ??= 而不是測試 null。

常量建構函式首選 const。

首選在 @immutable 類上宣告 const 建構函式。

宣告時首選 const 而非 final。

在 @immutable 類上，建構函式的引數首選 const 字面量。

首選定義建構函式而不是靜態方法來建立例項。

List 和 String 例項使用 contains。

在不需要轉義序列的地方首選雙引號。

使用 = 將命名引數與其預設值分開。

對於主體是單個返回語句的簡短成員使用 =>。

私有欄位可以是 final。

如果引用未重新賦值，for-each 迴圈變數首選 final。

如果變數宣告未重新賦值，首選 final。

如果引數宣告未重新賦值，首選 final。

從可迭代物件構建對映時首選 for 元素。

僅使用 forEach 將函式應用於所有元素。

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

首選泛型函式類型別名。

如果可能，首選 if 元素而不是條件表示式。

首選使用 ?? 運算子。

儘可能使用初始化形參。

儘可能內聯列表項宣告。

首選 int 字面量而不是 double 字面量。

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

Iterable 和 Map 使用 isEmpty。

Iterable 和 Map 使用 isNotEmpty。

首選 is! 運算子。

首選在可迭代物件上使用 whereType。

首選使用 mixin。

首選空感知方法呼叫。

首選使用空感知運算子。

對於 lib/ 中的檔案，首選相對匯入。

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

儘可能使用展開集合。

首選為未初始化變數和欄位新增型別。

不要使用 Null 型別，除非您確定不想要 void。

透過 @Deprecated("message") 提供棄用訊息。

文件化所有公共成員。

屬性 getter 遞迴返回自身。

所有引數列表和引數列表都使用尾隨逗號。

在 pubspec.yaml 中使用安全 URL。

用於空白的 SizedBox。

使用 SizedBox 的 shrink 和 expand 命名建構函式。

文件註釋首選使用 ///。

在 widget 例項建立中，將子屬性放在最後排序。

將建構函式宣告排在其他成員之前。

按字母順序排序 pub 依賴項。

將未命名建構函式宣告排在首位。

為區域性變數指定非明顯的型別註解。

為頂層和靜態變數指定非明顯的型別註解。

指定型別註解。

將 super 呼叫放在建構函式初始化列表的最後。

避免對 'Type' 進行 switch 語句。

在 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。

對於用非空值初始化的 final 變數，使用非空型別。

不要重寫方法以使用相同引數呼叫父方法。

可以移除不必要的小括號。

不必要的原始字串。

避免使用不必要的語句。

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

不必要的字串插值。

除非避免遮蔽，否則不要使用 this 訪問成員。

展開中不必要的 toList()。

不必要的 'unawaited' 使用。

可以移除不必要的下劃線。

可執行庫中不可達的頂層成員。

使用不相關型別的引用呼叫相等運算子 ==。

避免不安全的 HTML API。

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

不要在非同步間隙中使用 BuildContext。

使用 ColoredBox。

使用 DecoratedBox。

使用列舉而不是行為像列舉的類。

例項化 Color 時首選 8 位十六進位制整數（例如 0xFFFFFFFF）。

引數使用泛型函式型別語法。

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

首選 intValue.isOdd/isEven 而不是檢查 % 2 的結果。

在 widget 建構函式中使用 key。

對非空型別的私有成員使用 late。

使用預定義的命名常量。

測試 null 的 if 元素可以用空感知元素替換。

使用原始字串以避免轉義。

使用 rethrow 重新丟擲捕獲的異常。

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

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

在 part of 指令中使用字串。

儘可能使用超初始化器引數。

使用 throwsA 匹配器而不是 fail()。

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

使用截斷除法。

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

不要賦值給 void。