掌握GitHub Actions 教学工作区 · 课程 0002 · 约 8 分钟 · 前置:0001 · 三种跑法 · 2026-10-06

一个 workflow 的骨架

你能做到:打开任何一个 .github/workflows/*.yml,逐段说出它什么时候跑、跑在哪台机器上、每一步干什么。

1 | 五个零件

workflow(工作流):一个写在 .github/workflows/ 下的 YAML 文件,描述「什么事件发生时、在什么机器上、按什么顺序做什么」。一个仓库可以有多个。 像一张菜谱:写着什么时候做、用哪个灶、先下什么后下什么。

零件它是什么在 YAML 里长什么样
on触发条件:什么事件发生时启动on: [push] / on: schedule
jobs作业:一段独立的任务,跑在自己的一台机器上jobs: build:
runs-on这个作业要哪种机器runs-on: ubuntu-latest
steps步骤:作业里按顺序执行的若干动作steps: 下面的一串 -
uses / run一步要么调用别人写好的 Action,要么直接跑一条命令- uses: actions/checkout@v4 / - run: npm ci

这五个词的关系是包含关系:workflow 里有若干 job,一个 job 跑在一台机器上,机器里依次跑若干 step,每个 step 不是 uses 就是 run。

2 | 最小例子

文件放在仓库根的 .github/workflows/check.yml:

name: check          # 流程的名字,只影响界面与徽章上显示什么
on: [push]           # 触发条件:每次 push 都跑
jobs:
  test:              # 作业名,自己起
    runs-on: ubuntu-latest   # 用哪种机器
    steps:
      - uses: actions/checkout@v4   # 第 1 步:把仓库代码取到这台机器上
      - uses: actions/setup-node@v4 # 第 2 步:把 Node 装好
        with:
          node-version: 22
      - run: npm ci                # 第 3 步:按锁文件装依赖
      - run: npm test              # 第 4 步:跑测试

逐段读一遍:名字是 check;每次推送触发;一个叫 test 的作业;跑在 Ubuntu 最新版上; 四步依次是「取代码 → 装 Node → 装依赖 → 跑测试」。这就是绝大多数 workflow 的样子。

3 | 三个反直觉的规矩

4 | 怎么读一个陌生文件

5 | 常见误解

6 | 练习

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

1. 一个 workflow 里有两个 job,它们在什么上面跑?

对。一个 job 对应一台机器,这是硬规定:所以在 A 里生成的文件,B 默认看不到;要传就得上传产物或用缓存。

2. 为什么几乎每条流程的第一步都是取出代码?

对。托管 runner 每次都是全新机器,仓库内容不会自动出现;不取代码,后面的 npm ci 连 package.json 都找不到。

3. 一个 job 的第 3 步失败了,接下来会发生什么?

对。默认行为是「失败即中断这个作业」;想让它继续得显式写 continue-on-error。其它 job 不受影响,会照旧跑完。