首页/开发/CI/CD 与发布速查/GitHub Actions matrix 矩阵
工具链要点63 条

GitHub Actions matrix 矩阵

一次定义多环境组合:strategy.matrix 展开为多个并行作业,支持 include 追加组合、exclude 排除组合与 fail-fast 控制。

CI/CD 与发布速查开发更新于 2026-10-12
维度变量数组
include/exclude追加或排除组合
fail-fast默认 true:一个失败取消其他
并发max-parallel 限制同时运行数

矩阵与排除

矩阵与排除
jobs:
  test:
    strategy:
      fail-fast: false
      matrix:
        os: [ubuntu-latest, windows-latest]
        node: [20, 22]
        exclude:
          - os: windows-latest
            node: 20
    runs-on: ${{ matrix.os }}
    steps:
      - run: node --version
include 可追加新组合或为已有组合附加属性;注意它与 exclude 的作用顺序。

易错点

  • 组合数膨胀:额度与排队时间上升,先算清规模
  • 依赖 Runner 镜像中的工具版本:不同镜像上行为漂移

数据来源与参考

  • GitHub Docs《Using a matrix for your jobs》
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌