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

触发与调度:什么时候把流程叫起来

你能做到:写对 on 这一段,并说出定时任务为什么不会准点、以及公开仓库的定时任务为什么可能自己停掉。

1 | 谁把流程叫起来

事件什么时候发生典型用途
push有人往仓库推了提交每次提交都跑检查
pull_request合并请求被打开、更新、重新打开合并前拦住问题
schedule到点(用 cron 写)定时抓数据、定时体检
workflow_dispatch有人手动点一下,或在别处调接口不常跑、但要能随时跑的任务
workflow_call被另一个工作流调用把一段流程做成可复用的积木
release / repository_dispatch发布了版本 / 被外部系统点名触发发版打包、和别的系统对接

可以同时写多个:on: [push, workflow_dispatch] 表示「推送时跑,我也能手动跑一次」—— 给定时任务加上手动触发,是最省事的调试习惯。

2 | 过滤:不是所有推送都要跑

on:
  push:
    branches: [master]          # 只在这些分支被推送时跑
    paths: ["src/**", "package.json"]   # 只有这些文件变了才跑
  pull_request:
    types: [opened, synchronize, reopened]

3 | 定时:五个格子的 cron

on:
  schedule:
    - cron: "30 0 * * *"    # UTC 每天 00:30(北京时间 08:30)

4 | 手动触发与它的输入

on:
  workflow_dispatch:
    inputs:
      env:
        description: "在哪个环境上跑"
        default: "staging"
        options: ["staging", "prod"]

这样在仓库的 Actions 页面会出现一个「Run workflow」按钮,还能先填两个参数。 输入值在流程里用 ${{ inputs.env }} 取。 它不解决调度,解决的是「人想跑就跑」 —— 调试、补跑、给非开发同事一个入口,都靠它。

5 | 常见误解

6 | 练习

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

1. 想让它「北京时间每天 9:00」跑,cron 该写几点?

对。9 - 8 = 1,cron 写 0 1 * * *。平台只看 UTC,不会替你做时区换算。

2. 公开仓库的定时任务为什么可能自己停掉?

对。官方口径是连续 60 天没有仓库活动就暂停定时任务,推一次提交即可唤醒 —— 所以「悄悄停掉」是很常见的排查盲区。

3. 给一条定时流程同时加上手动触发,好处是什么?

对。定时流程最难受的就是「想验证一次得等到明天」;加 workflow_dispatch 之后随时能跑 —— 顺带还能给不写代码的人一个入口。