Rust / 系统课时
设置测试矩阵覆盖关键平台
设置测试矩阵覆盖关键平台
CI 测试矩阵的目标不是把所有组合都跑一遍,而是在有限执行成本下覆盖真正有风险的 Rust 工具链、操作系统和 Cargo feature 组合。本篇从最小矩阵开始,演示如何定义组合、避免组合爆炸,并让每个任务都执行同一套测试命令。
学习目标
- 理解 Rust CI 矩阵中的工具链、操作系统和 feature 三个维度
- 能识别必须覆盖与可以抽样的组合
- 能用 GitHub Actions 矩阵表达跨平台测试任务
先定义覆盖维度
一个 Rust 项目常见的 CI 维度包括 Rust toolchain、OS 和 feature。它们并不是必须全部笛卡尔积组合,而应根据代码实际依赖和平台风险决定。
例如,一个需要稳定版和最低支持版本、同时依赖 Linux 与 Windows 行为差异的项目,可以先覆盖两种工具链和两种操作系统。feature 再按业务风险拆成默认组合与关键 feature 组合。

用矩阵表达测试任务
下面是一个 GitHub Actions 的最小示例。它同时覆盖 Rust 稳定版与最低支持版本,并覆盖 Ubuntu 与 Windows;feature 组合只加入一个需要重点验证的案例。这里的 1.80.0 只是示例版本,实际项目应替换为仓库声明的最低支持版本。
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预期结果
各矩阵任务分别在对应操作系统和 Rust 工具链上启动,并执行 cargo test。
任务全部通过后,CI job 全部显示成功;任一组合失败,对应矩阵任务显示失败。这个例子有一个重要问题:矩阵虽然定义了 features,测试命令却固定使用了 --all-features,所以 features 这一维实际上没有产生不同测试行为。若确实需要按 feature 切换,应让矩阵值直接影响命令,而不是只改变任务名称。
让 feature 真正参与测试
可以把 feature 作为命令参数的一部分。下面仍是片段示例,依赖前面的 GitHub Actions job 上下文。
- name: Run tests
shell: bash
run: cargo test --all-targets ${{ matrix.features }}预期结果
features="" 时执行默认 feature 测试;
features="--features cli" 时额外启用 cli feature 并执行对应测试。矩阵设计中尤其要避免“名义覆盖”。例如同时声明多个 feature,却让所有任务都使用相同命令,表面上矩阵很大,实际测试路径却没有增加。
控制组合数量
如果有 3 个操作系统、3 个工具链和 4 组 feature,直接做全组合会得到 个任务。组合越大,执行时间和失败排查成本越高,因此通常先确定每个维度中必须覆盖的风险,再选择少量代表组合。
可以把稳定版作为广泛覆盖基线,把最低支持版本用于兼容性检查,再针对平台专属代码增加对应 OS;只有对 feature 行为确实敏感的组合才单独加入矩阵。这样的设计比盲目扩大矩阵更容易长期维护。
测试矩阵最终应形成一张可解释的覆盖表:每个任务都能回答“验证了哪个风险”。当代码、最低支持版本或平台行为发生变化时,再据此增删组合,CI 才不会逐年变成难以维护的大型任务集合。