掌握GitHub Actions 教学工作区 · 课程 0003 · 约 8 分钟 · 前置:0002 · workflow 的骨架 · 2026-10-06

Runner 与矩阵:代码到底在哪台机器上跑

你能做到:看到 runs-on 就知道这台机器什么脾气,并说清一个矩阵为什么会让作业数成倍增长。

1 | 机器的三种来源

写法谁提供的机器生命周期什么时候用它
ubuntu-latest / windows-latest / macos-latest平台这一次作业,跑完销毁默认选择:绝大多数流程都用它
self-hosted你自己长期在线,一直等着派活要特定硬件、要连内网、要很大的缓存
更大的托管机型(按量付费)平台同托管,只是规格更高编译特别重、内存不够用的时候

托管机型的系统与预装软件由平台维护,所以「碰巧装好了」这件事不可依赖: 官方会随镜像更新换掉工具版本。要稳,就把版本显式写进流程里(比如用 setup-node 指定 node-version)。

2 | 矩阵:一条流程,多个作业

同一段步骤要在几个组合上各跑一遍时,不需要复制粘贴 —— 用 strategy.matrix 声明变量,平台替你展开:

jobs:
  test:
    runs-on: ${{ matrix.os }}
    strategy:
      matrix:
        os: [ubuntu-latest, windows-latest]
        node: [20, 22]
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
        with:
          node-version: ${{ matrix.node }}
      - run: npm ci
      - run: npm test

两个系统 × 两个版本 = 四个作业,各自开一台机器、各自完整地跑一遍。 ${{ matrix.xxx }} 就是「这次该用哪个值」的占位符。

3 | 自建 runner:把「机器」这一步也拿回来

自建 runner 就是在自己机器上跑一个代理程序,它向平台报到、等派活。需要它的场合通常只有三个:

代价也清楚:那台机器要你维护(更新、磁盘、安全补丁),而且它会记住上一次跑过的东西。 更要紧的是安全 —— 官方明确提醒:给公开仓库配自建 runner 有风险,因为外部提交的流程可能在那台机器上执行。

4 | 常见误解

5 | 练习

三题自测,每题只有一个正确选项;选完立刻看到解释。

1. 矩阵写了 3 个系统 × 2 个版本,会跑多少个作业?

对。维度之间是相乘的关系,3 × 2 = 6 个作业,各开一台机器;这就是矩阵会快速吃掉额度的原因。

2. 什么情况下最该考虑自建 runner?

对。内网可达、特殊硬件、大缓存是自建的三个正当理由;而它恰恰是更要维护、以及给公开仓库用时更有风险的那条路。

3. 自建 runner 与托管 runner 最关键的行为差别是什么?

对。托管 runner 每次都是干净机器;自建的那台会累积状态,上一次留下的文件和改动会影响这一次 —— 所以清理步骤要自己写。