Rust / 系统课时

设置测试矩阵覆盖关键平台

设置测试矩阵覆盖关键平台

CI 测试矩阵的目标不是把所有组合都跑一遍,而是在有限执行成本下覆盖真正有风险的 Rust 工具链、操作系统和 Cargo feature 组合。本篇从最小矩阵开始,演示如何定义组合、避免组合爆炸,并让每个任务都执行同一套测试命令。

学习目标

  • 理解 Rust CI 矩阵中的工具链、操作系统和 feature 三个维度
  • 能识别必须覆盖与可以抽样的组合
  • 能用 GitHub Actions 矩阵表达跨平台测试任务

先定义覆盖维度

一个 Rust 项目常见的 CI 维度包括 Rust toolchain、OS 和 feature。它们并不是必须全部笛卡尔积组合,而应根据代码实际依赖和平台风险决定。

例如,一个需要稳定版和最低支持版本、同时依赖 Linux 与 Windows 行为差异的项目,可以先覆盖两种工具链和两种操作系统。feature 再按业务风险拆成默认组合与关键 feature 组合。

Rust CI 测试矩阵的维度与组合关系

用矩阵表达测试任务

下面是一个 GitHub Actions 的最小示例。它同时覆盖 Rust 稳定版与最低支持版本,并覆盖 Ubuntu 与 Windows;feature 组合只加入一个需要重点验证的案例。这里的 1.80.0 只是示例版本,实际项目应替换为仓库声明的最低支持版本。

yaml
name: test

on:
  push:
  pull_request:

jobs:
  test:
    strategy:
      fail-fast: false
      matrix:
        os: [ubuntu-latest, windows-latest]
        rust: [stable, 1.80.0]
        features: ["", "cli"]
    runs-on: ${{ matrix.os }}

    steps:
      - uses: actions/checkout@v4

      - name: Install Rust
        uses: dtolnay/rust-toolchain@stable
        with:
          toolchain: ${{ matrix.rust }}

      - name: Run tests
        shell: bash
        run: cargo test --all-targets --all-features

预期结果

text
各矩阵任务分别在对应操作系统和 Rust 工具链上启动,并执行 cargo test。
任务全部通过后,CI job 全部显示成功;任一组合失败,对应矩阵任务显示失败。

这个例子有一个重要问题:矩阵虽然定义了 features,测试命令却固定使用了 --all-features,所以 features 这一维实际上没有产生不同测试行为。若确实需要按 feature 切换,应让矩阵值直接影响命令,而不是只改变任务名称。

让 feature 真正参与测试

可以把 feature 作为命令参数的一部分。下面仍是片段示例,依赖前面的 GitHub Actions job 上下文。

yaml
- name: Run tests
  shell: bash
  run: cargo test --all-targets ${{ matrix.features }}

预期结果

text
features="" 时执行默认 feature 测试;
features="--features cli" 时额外启用 cli feature 并执行对应测试。

矩阵设计中尤其要避免“名义覆盖”。例如同时声明多个 feature,却让所有任务都使用相同命令,表面上矩阵很大,实际测试路径却没有增加。

控制组合数量

如果有 3 个操作系统、3 个工具链和 4 组 feature,直接做全组合会得到 3×3×4=363\times3\times4=36 个任务。组合越大,执行时间和失败排查成本越高,因此通常先确定每个维度中必须覆盖的风险,再选择少量代表组合。

可以把稳定版作为广泛覆盖基线,把最低支持版本用于兼容性检查,再针对平台专属代码增加对应 OS;只有对 feature 行为确实敏感的组合才单独加入矩阵。这样的设计比盲目扩大矩阵更容易长期维护。

测试矩阵最终应形成一张可解释的覆盖表:每个任务都能回答“验证了哪个风险”。当代码、最低支持版本或平台行为发生变化时,再据此增删组合,CI 才不会逐年变成难以维护的大型任务集合。

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

目录与阅读设置

阅读设置

17

记录一个想法

设置测试矩阵覆盖关键平台

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

登录哪都通