跨平台开发 / 系统课时
配置 test 与 lints 依赖
配置 test 与 lints 依赖
测试代码和静态检查规则都属于开发阶段工具,不应该成为应用运行时依赖。本篇完成 test 与 lints 的开发依赖配置,并启用推荐 lint 规则,最后用分析器确认配置已经生效。
学习目标
- 正确把
test与lints放入开发依赖 - 理解版本约束与依赖解析的基本作用
- 启用推荐 lint 规则并验证分析配置
把开发工具放入 dev_dependencies
Dart 的 pubspec.yaml 使用 dependencies 保存应用运行或公共库代码真正依赖的包,使用 dev_dependencies 保存测试、静态检查、代码生成等仅在开发阶段使用的工具。
test 通常只被 test/ 下的测试代码导入,lints 则提供分析器使用的规则集合,因此两者都适合作为开发依赖。这样其他项目依赖你的包时,不会因为这些开发工具额外引入无关依赖。
在项目根目录执行:
dart pub add dev:test dev:lints预期输出如下,实际解析版本和依赖变更数量可能不同:
Resolving dependencies...
...
Changed <N> dependencies!命令成功后,pubspec.yaml 会出现 dev_dependencies。Pub 会根据当前 Dart SDK、其他依赖以及版本约束解析一组彼此兼容的实际版本,并记录到锁文件中。
理解版本约束
依赖声明经常使用插入符约束。例如下面只是用于说明约束语义的片段示例,不代表推荐当前项目固定使用该版本:
dev_dependencies:
test: ^1.2.3^1.2.3 表示允许 Pub 在兼容范围内选择更新版本,而不是永远锁死在 1.2.3。项目真正解析出的版本由 pubspec.lock 记录,因此团队提交锁文件后,可以让同一个应用项目获得更稳定、可重复的依赖解析结果。
不要为了追求“最新”手工删除版本约束。依赖约束表达项目允许接受的版本范围,而锁文件负责记录一次具体解析结果,两者承担的职责不同。
启用推荐 lint 规则
安装 lints 只代表规则包已经可用,还需要通过项目根目录的 analysis_options.yaml 告诉 Dart 分析器加载哪一组规则。对于普通 Dart 项目,可以从推荐规则开始:
include: package:lints/recommended.yaml这是配置文件,不会单独产生控制台输出。保存后,IDE 的 Dart 分析功能以及 dart analyze 都会读取该文件;以后如果项目需要更严格或更宽松的规则,再在此基础上按团队约定调整。
验证依赖和分析配置
依赖成功解析且 analysis_options.yaml 已保存后,执行静态分析:
dart analyze预期结果:如果当前项目没有违反启用的规则,命令应成功结束;如果已有问题,则分析器会列出具体文件、位置和诊断信息,这同样说明 lint 配置已经被读取。
无诊断问题:退出状态为 0。
存在诊断问题:终端列出对应问题,需要根据严重级别和项目规则处理。如果出现无法找到 package:lints/recommended.yaml 的错误,优先检查 lints 是否确实位于当前项目的 dev_dependencies,然后重新完成依赖解析。若 dart pub add 本身无法解析依赖,则先处理 SDK 版本约束或其他包之间的版本冲突,而不是直接修改锁文件。
完成这一步后,项目已经具备两个基础能力:test 提供可执行的测试框架,lints 为分析器提供统一的代码规则。测试结果和静态分析结果也因此可以在本地与后续自动化流程中重复执行。