Linter 规则

声明方法返回类型。

将控制结构表达式与其语句分开。

将必需的命名参数放在最前面。

在没有默认值的命名参数上指定 @required。

指定类型注解。

避免对 lib/ 中的文件使用相对导入。

注解重写成员。

注解重新声明的成员。

在不需要时避免使用 dynamic 注解。

避免使用 as。

避免在条件表达式中使用 bool 字面量。

避免没有 on 子句的 catch。

不要显式捕获 Error 或实现它的类型。

避免定义仅包含静态成员的类。

避免 double 和 int 检查。

避免在 dynamic 目标上进行方法调用或属性访问。

避免在 else 子句中使用空语句。

避免在未标记为 @immutable 的类上重载运算符 == 和 hashCode。

通过转换周围的引号来避免转义内部引号。

避免在 const 类中使用字段初始化器。

避免为参数声明使用 final。

避免在 forEach 中使用函数字面量。

避免使用 'FutureOr' 作为结果的类型。

不要实现重写 == 的类。

不要显式将变量初始化为 null。

避免 JavaScript 四舍五入的整数。

不要在单行上声明多个变量。

不要在自定义 == 运算符中检查 null。

避免位置布尔参数。

避免在生产代码中调用 print。

避免私有 typedef 函数。

避免冗余的参数值。

避免对 lib/ 中的文件使用相对导入。

不要重命名重写方法的参数。

避免在 setters 上使用返回类型。

避免从返回类型为 bool、double、int 或 num 的成员返回 null。

避免为 Future 返回 null。

避免为 void 返回 null。

避免从方法中返回 this 仅仅是为了启用流畅的接口。

避免没有 getters 的 setters。

避免遮蔽类型参数。

避免在表达式语句中使用单个级联。

避免缓慢的异步 dart:io 方法。

避免在生产代码中使用 .toString()，因为结果可能会被最小化。

避免将类型用作参数名称。

避免为函数表达式参数注解类型。

避免不必要的容器。

避免重写 final 字段以在多次调用时返回不同的值。

避免在构造函数中定义未使用的参数。

避免返回 void 的 async 函数。

避免在 Flutter web 插件包外部使用仅限 Web 的库。

仅等待 futures。

使用 UpperCamelCase 命名扩展。

使用 UpperCamelCase 命名类型。

取消 dart:async StreamSubscription 的实例。

在同一引用上级联连续的方法调用。

不要将可空值强制转换为不可空类型。

关闭 dart:core Sink 的实例。

使用不相关类型的参数调用各种集合方法。

按字母顺序排列组合器名称。

仅在文档注释中引用作用域内的标识符。

缺少条件导入。

常量名称首选使用 lowerCamelCase。

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

对所有流控制结构都使用花括号。

将库文档注释附加到库指令。

依赖于引用的包。

缺少 deprecated 注解。

避免从声明它们的包中使用已弃用的元素。

在 debug 方法中引用所有公共属性。

遵守 Effective Dart Guide 指令排序约定。

不要在非 async 块中调用异步函数。

不要使用环境声明的变量。

文档忽略注释。

避免空的 catch 块。

对于空的构造函数体，使用 ; 而不是 {}。

避免空语句。

请使用健全的空安全。

在文件末尾放置一个空行。

为类枚举中的所有常量定义 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 参数名称。

代码块缺少指定的语言。

相邻字符串之间缺少空格。

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

没有 default case。

不要使用多个具有相同值的 case。

避免为库前缀使用前导下划线。

避免为本地标识符使用前导下划线。

不要将布尔表达式与布尔字面量进行比较。

不要在 createState 中放置任何逻辑。

避免在 runtimeType 上调用 toString()。

不要将变量赋值给自己。

不要使用通配符参数或变量。

使用 lowerCamelCase 命名非常量标识符。

空操作原始操作。

不要在可能为空的类型参数上使用 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。

从 iterables 构建 maps 时，首选 for 元素。

仅将函数应用于所有元素时，使用 forEach。

使用函数声明将函数绑定到名称。

首选泛型函数类型别名。

在可能的情况下，首选 if 元素而不是条件表达式。

首选使用 ?? 运算符。

尽可能使用初始化形参。

尽可能内联列表项声明。

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

使用插值来组合字符串和值。

对于 Iterables 和 Maps，使用 isEmpty。

对于 Iterables 和 Maps，使用 isNotEmpty。

首选 is! 运算符。

首选在 iterable 上使用 whereType。

首选使用 mixins。

首选 null 感知方法调用。

首选使用 null 感知运算符。

对于 lib/ 中的文件，首选相对导入。

仅对包含单引号的字符串使用双引号。

尽可能使用 spread collections。

首选键入未初始化的变量和字段。

除非您确定您不需要 void，否则不要使用 Null 类型。

通过 @Deprecated("message") 提供弃用消息。

为所有公共成员编写文档。

属性 getter 递归返回自身。

对所有参数列表和参数列表使用尾随逗号。

在 pubspec.yaml 中使用安全 urls。

SizedBox 用于空白。

使用 SizedBox shrink 和 expand 命名构造函数。

文档注释首选使用 ///。

在 widget 实例创建中，将 child 属性排在最后。

在其他成员之前对构造函数声明进行排序。

按字母顺序排列 pub 依赖项。

首先对未命名的构造函数声明进行排序。

为局部变量指定非显而易见的类型注解。

为顶层和静态变量指定非显而易见的类型注解。

指定类型注解。

将 super 调用放在构造函数初始化列表的最后。

在 operator ==(Object other) 中测试参数类型。

避免在 finally 块中使用 throw。

收紧初始化形参的类型。

为公共 API 添加类型注解。

不要为初始化形参添加类型注解。

不要在常量模式中使用类型字面量。

async 函数体中的 Future 结果必须使用 await 等待，或者使用 dart:async 标记为 unawaited。

文档注释中的尖括号会被 Markdown 视为 HTML。

没有 await 就不要有 async。

返回语句中不必要的 await 关键字。

在不需要时，避免在字符串插值中使用大括号。

当 break 是隐含的时，不要使用显式的 break。

避免 const 关键字。

不必要的 .new 构造函数名。

局部变量不要使用 final。

避免为了“安全”而将字段包装在 getter 和 setter 中。

不要忽略未产生的诊断代码。

当 tear-off 可以胜任时，不要创建 lambda。

当不需要时，不要指定 late 修饰符。

除非库指令有文档注释或注解，否则避免使用库指令。

不要在 library 声明中使用库名称。

不必要的 new 关键字。

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

在可空类型的扩展上使用不必要的空感知运算符。

不必要的 null 检查。

在 ?? 运算符中避免使用 null。

对于用非空值初始化的 final 变量，使用非空类型。

不要为了使用相同的参数调用超类方法而重写方法。

可以移除不必要的括号。

不必要的原始字符串。

避免使用不必要的语句。

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

不必要的字符串插值。

除非为了避免遮蔽，否则不要使用 this 访问成员。

展开运算符中不必要的 toList()。

可以移除不必要的下划线。

可执行库中无法访问的顶层成员。

使用不相关类型的引用调用相等运算符 ==。

避免不安全的 HTML API。

不安全的类型：在非协变位置具有类型变量。

不要跨异步间隙使用 BuildContext。

使用 ColoredBox。

使用 DecoratedBox。

使用枚举而不是行为类似于枚举的类。

实例化 Color 时，优先使用 8 位十六进制整数（例如，0xFFFFFFFF）。

为参数使用泛型函数类型语法。

使用 ?? 运算符将 null 转换为 bool。

优先使用 intValue.isOdd/isEven 而不是检查 % 2 的结果。

在 Widget 构造函数中使用 key。

对于具有非空类型的私有成员，使用 late。

使用预定义的命名常量。

使用原始字符串以避免转义。

尽可能使用 rethrow 重新抛出捕获的异常。

对于概念上更改属性的操作，使用 setter。

使用字符串缓冲区来组合字符串。

在 part of 指令中使用字符串。

尽可能使用超类初始化参数。

使用 throwsA matcher 而不是 fail()。

如果适用，方法名称以 to/_to 或 as/_as 开头。

使用截断除法。

使用有效的正则表达式语法。

不要赋值给 void。