跨平台开发 / 系统课时
在 CI 执行测试与静态分析
在 CI 执行测试与静态分析
本地检查只有在每个人都主动执行时才有效。把格式检查、静态分析和测试放进 CI 后,每次 Pull Request 都会在干净环境中重跑同一组命令,并把失败暴露为状态检查。本节用 GitHub Actions 建立这条最小质量流水线。
学习目标
- 在 CI Runner 中安装 Dart 依赖并依次执行格式、分析和测试
- 理解命令退出码如何转换为 CI Job 的成功或失败
- 区分“CI 检查失败”和“仓库规则真正禁止合并”这两个环节
让 CI 复现本地检查
一个可靠的质量 Job 不需要复杂编排,关键是顺序稳定且任何一步失败都不能被吞掉。典型链路是:检出代码、安装 Dart SDK、解析依赖、检查格式、执行静态分析、运行测试,最后由 Job 状态反馈给 Pull Request。

CI 的重要性质是环境独立。不要依赖开发机已经安装的全局工具,也不要在前一步失败后强行继续执行后面的门槛。这样一次失败就能直接定位到格式、分析或测试中的具体阶段。
配置 GitHub Actions
在仓库中创建 .github/workflows/quality.yml。下面的工作流在 Pull Request 和推送到 main 时执行,使用只读仓库权限,不需要额外密钥。
name: Dart quality
on:
pull_request:
push:
branches:
- main
jobs:
quality:
runs-on: ubuntu-latest
permissions:
contents: read
steps:
- name: Checkout
uses: actions/checkout@v7
- name: Setup Dart
uses: dart-lang/setup-dart@v1
with:
sdk: stable
- name: Install dependencies
run: dart pub get
- name: Check formatting
run: dart format --output=none --set-exit-if-changed .
- name: Static analysis
run: dart analyze --fatal-infos
- name: Run tests
run: dart test生效后,每次满足触发条件的提交都会产生名为 quality 的 Job。dart format --set-exit-if-changed 在发现需要重新格式化的文件时返回失败;dart analyze --fatal-infos 会把 info 级诊断也纳入失败条件;dart test 只要存在失败测试,Job 就会失败。
先在本地复现同一组命令
CI 失败时,第一步不是反复重新运行流水线,而是在仓库根目录执行同一组命令。下面的命令只在所有检查都成功时输出最后一行,因此可以快速确认本地是否已达到 CI 条件。
dart pub get >/dev/null &&
dart format --output=none --set-exit-if-changed . >/dev/null &&
dart analyze --fatal-infos >/dev/null &&
dart test >/dev/null &&
echo "CI checks passed"预期输出
CI checks passed如果命令没有打印该行,说明链路中至少有一步返回了非零退出码。此时单独执行对应命令获取完整诊断,比在 CI 日志中盲目重试更高效。
让失败真正阻止合并
工作流失败本身只会产生一个失败的状态检查。要把它变成合并门禁,还需要在仓库的分支保护或 Ruleset 中把 quality 设置为必需状态检查。这样 Pull Request 只有在该 Job 成功后才满足合并条件。
如果团队还要检查覆盖率,最稳妥的做法是把覆盖率判断封装成仓库内脚本,再让本地和 CI 调用同一个入口,而不是在 YAML 中复制一套不同逻辑。CI 的核心不是“多跑几条命令”,而是让同一套可执行质量规则在每次变更上自动、可重复地执行。