首页/开发/CI/CD 与发布速查/GitHub Actions 工作流结构
工具链要点63 条

GitHub Actions 工作流结构

工作流文件位于 .github/workflows:name、on、jobs 为核心结构;每个作业在自己的 runner 上顺序执行一组步骤。

CI/CD 与发布速查开发更新于 2026-10-12
位置.github/workflows/*.yml
on触发事件
jobs作业集合,各带 runs-on
stepsuses 调用动作、run 执行命令

最小工作流

最小工作流
name: ci
on: [push]
jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - run: make build
步骤默认顺序执行、任一失败即中止该作业;跨作业协作通过 needs 与 outputs。

易错点

  • run 多行脚本任一行失败即中止:预期失败要显式处理
  • uses 未固定主版本:动作升级可能引入不兼容变更

数据来源与参考

  • GitHub Docs《Workflow syntax for GitHub Actions》
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌