跨平台开发 / 系统课时

在 CI 执行测试与静态分析

在 CI 执行测试与静态分析

本地检查只有在每个人都主动执行时才有效。把格式检查、静态分析和测试放进 CI 后,每次 Pull Request 都会在干净环境中重跑同一组命令,并把失败暴露为状态检查。本节用 GitHub Actions 建立这条最小质量流水线。

学习目标

  • 在 CI Runner 中安装 Dart 依赖并依次执行格式、分析和测试
  • 理解命令退出码如何转换为 CI Job 的成功或失败
  • 区分“CI 检查失败”和“仓库规则真正禁止合并”这两个环节

让 CI 复现本地检查

一个可靠的质量 Job 不需要复杂编排,关键是顺序稳定且任何一步失败都不能被吞掉。典型链路是:检出代码、安装 Dart SDK、解析依赖、检查格式、执行静态分析、运行测试,最后由 Job 状态反馈给 Pull Request。

Pull Request 到 CI 状态检查的执行链路

CI 的重要性质是环境独立。不要依赖开发机已经安装的全局工具,也不要在前一步失败后强行继续执行后面的门槛。这样一次失败就能直接定位到格式、分析或测试中的具体阶段。

配置 GitHub Actions

在仓库中创建 .github/workflows/quality.yml。下面的工作流在 Pull Request 和推送到 main 时执行,使用只读仓库权限,不需要额外密钥。

yaml
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 条件。

bash
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"

预期输出

text
CI checks passed

如果命令没有打印该行,说明链路中至少有一步返回了非零退出码。此时单独执行对应命令获取完整诊断,比在 CI 日志中盲目重试更高效。

让失败真正阻止合并

工作流失败本身只会产生一个失败的状态检查。要把它变成合并门禁,还需要在仓库的分支保护或 Ruleset 中把 quality 设置为必需状态检查。这样 Pull Request 只有在该 Job 成功后才满足合并条件。

如果团队还要检查覆盖率,最稳妥的做法是把覆盖率判断封装成仓库内脚本,再让本地和 CI 调用同一个入口,而不是在 YAML 中复制一套不同逻辑。CI 的核心不是“多跑几条命令”,而是让同一套可执行质量规则在每次变更上自动、可重复地执行。

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

目录与阅读设置

阅读设置

17

记录一个想法

在 CI 执行测试与静态分析

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

登录哪都通