SuperAPI AI 工具集

dart-best-practices

测试与质量

查看项目

更新于 10-15 22:13

技能介绍

用途:为 Dart 项目提供代码质量约定,帮助统一风格、提升可读性并规避常见反模式。优先级标注为 P1(HIGH)。

主要能力与约定: 作用域方面,不使用全局变量;确需私有全局变量时以 _ 开头。不可变性遵循 const > final > var 的层级。配置使用 --dart-define 传递密钥,禁止硬编码 API key。命名遵循 effective-dart:类用 PascalCase,成员用 camelCase。字符串优先单引号,仅在需要插值时使用双引号。多行字面量或参数始终使用尾随逗号。单表达式函数与 getter 优先使用 => 表达式体。

集合惯用法:在可提升清晰度时,用 .map、.where、.fold、.any 替代手写循环;空集合需标注类型(如 <String>[]、<String, User>{})以避免 dynamic;使用集合 if/for 与展开运算符构建可组合的列表和映射。异步方面,除非有意 fire-and-forget,否则始终 await Future。导入组织上,包内文件使用相对导入,避免同包内使用 package 绝对导入。

反模式:非显而易见类型不用 var,改用 final 或显式类型,var 仅用于局部且类型明显的短作用域;同包内不使用 package 导入;不保留顶层可变状态,应封装进类或通过依赖注入提供;tear-offs 不用匿名 lambda,优先 list.forEach(doSomething) 而非匿名形式。

使用方式与限制:资料未提供具体安装命令、调用步骤或平台支持信息,暂未提供。该技能以规范约定为主,不涉及收费、价格或效果承诺。