跨平台开发 / 系统课时

在 CI 中执行 analyze 和 test

在 CI 中执行 analyze 和 test

本篇解决 Flutter 项目如何把静态分析和自动测试接入 CI 的问题,让代码质量检查从开发者习惯变成合并代码前的自动化规则。

学习目标

  • 理解 flutter analyze 和 flutter test 在 CI 中的职责
  • 掌握将质量检查命令加入自动化流程的方法
  • 能够根据失败结果定位代码质量问题

analyze 和 test 在 CI 中的职责

Flutter CI 中的质量检查通常分为两个层次。

flutter analyze 负责发现代码层面的潜在问题,例如类型错误、未使用代码、不符合分析规则的问题。它不执行程序逻辑,因此速度通常较快。

flutter test 负责验证代码行为,通过运行测试用例确认业务逻辑是否符合预期。

两者结合后,CI 可以同时覆盖代码规范和功能正确性。

配置 analyze 和 test 阶段

在基础流水线准备完成后,可以增加两个执行步骤。下面示例假设项目已经完成 flutter pub get。

yaml
steps:
  - name: Install dependencies
    run: flutter pub get

  - name: Static analysis
    run: flutter analyze

  - name: Run tests
    run: flutter test

预期结果

text
Run flutter analyze
No issues found!

Run flutter test
00:02 +3: All tests passed!

如果分析失败或测试失败,CI 任务会返回失败状态,代码合并流程可以根据仓库规则阻止继续执行。

如何处理 CI 失败

不同失败类型对应不同排查方向。

失败阶段 常见原因 优先检查
analyze 类型错误、Lint 规则失败 Dart 文件和 analysis_options.yaml
test 测试断言失败、环境差异 测试代码和依赖版本
pub get 依赖冲突 pubspec.yaml 和锁定版本

CI 失败时不要直接重跑任务。重复执行只能确认问题是否偶发,不能替代定位根因。

让测试成为合并门槛

团队通常会把 analyze 和 test 放入 Pull Request 检查中。这样每个提交都会经过相同规则验证,减少“本地能运行,合并后失败”的情况。

对于测试数量较多的项目,可以进一步区分快速单元测试和耗时较长的集成测试,让开发反馈速度和覆盖范围保持平衡。

验证质量门槛是否生效

可以故意制造一个分析错误或修改测试断言,提交代码后观察 CI 是否失败。

一个有效的质量门槛应该满足两个条件:问题代码能够被自动发现,修复后的代码能够稳定通过同一套检查流程。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

在 CI 中执行 analyze 和 test

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通