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。