CI/CD / 系统课时
看懂 Job、Step 与 Action
看懂 Job、Step 与 Action
阅读或修改 GitHub Actions 工作流时,最容易混淆的是 Job、Step 与 Action 的边界。本篇用一条可运行的 CI 流水线拆开三者:Job 决定独立运行单元,Step 表示顺序执行的步骤,Action 则把常用操作封装成可复用能力。
学习目标
- 区分 Job、Step 与 Action 各自负责的执行边界
- 看懂
jobs、steps、run与uses的层级关系 - 能根据任务粒度判断应该增加 Job、Step 还是复用 Action
三层结构分别解决什么问题
一个 workflow 可以包含多个 Job;一个 Job 在指定 Runner 上执行,并包含一组按顺序运行的 Step;Step 又可以直接执行 Shell 命令,也可以通过 uses 调用 Action。

Job 是调度和运行环境层面的边界。每个 Job 都通过 runs-on 选择 Runner;多个 Job 默认可以并行,需要先后关系时可使用 needs 建立依赖。
Step 是 Job 内部的执行单元。同一个 Job 中的 Step 默认按声明顺序执行,并共享该 Job 的工作目录和 Runner 环境,因此前一步生成的工作区文件可以被后一步读取。
Action 不是比 Step 更高的一层,而是 Step 可以调用的一种可复用实现。常见形式是 uses: owner/repository@ref。例如检出仓库通常不需要自己编写 Git 命令,而是调用 actions/checkout。
从一份工作流看执行边界
下面的工作流在推送代码时运行。test 是 Job;它包含三个 Step,其中第一个和第二个调用 Action,第三个直接执行命令。
name: job-step-action-demo
on:
push:
jobs:
test:
runs-on: ubuntu-latest
steps:
- name: Checkout repository
uses: actions/checkout@v4
- name: Setup Node.js
uses: actions/setup-node@v4
with:
node-version: '20'
- name: Print runtime
run: node --versionactions/checkout@v4 与 actions/setup-node@v4 都是 Action,通过 uses 被 Step 调用;node --version 则通过 run 直接交给 Runner 执行。配置提交到仓库的 .github/workflows/demo.yml 后,可在对应 workflow run 中查看三个 Step 的执行记录。
预期结果
v20.<ID>其中补丁版本 <ID> 会随 Runner 上实际安装和 Action 解析到的 Node.js 20 版本变化。关键验证点不是具体补丁号,而是该 Step 成功输出 v20 开头的版本号。
Job 为什么不能简单理解成步骤组
Job 还决定运行环境、权限和调度关系。例如测试 Linux 与 Windows 兼容性时,应使用不同 Job,因为它们需要不同 Runner;如果只是依次执行安装依赖、测试、构建,则通常放在同一个 Job 的多个 Step 中即可。
把所有事情拆成 Job 会增加 Runner 启动和跨 Job 传递数据的成本;反过来,把独立任务全部塞进一个 Job,又会失去并行执行和故障隔离能力。判断依据应是是否需要独立的运行环境或调度边界,而不是命令数量。
什么时候选哪一种
需要独立 Runner、不同操作系统、独立权限或并行执行时,拆成 Job。只需要在同一环境中按顺序完成一项操作时,增加 Step。某项操作需要跨项目重复使用,或者已有可靠的现成实现时,再优先考虑 Action。
因此,阅读工作流可以先找 jobs 确认运行边界,再沿 steps 看执行顺序,最后根据 run 与 uses 判断每一步究竟是直接执行命令还是调用封装好的 Action。