首页/开发/CI/CD 与发布速查/GitHub Actions 复合动作
工具链要点63 条

GitHub Actions 复合动作

把多个步骤打包成动作:action.yml 中 runs.using: composite 内联步骤,供同一作业或其他仓库复用。

CI/CD 与发布速查开发更新于 2026-10-12
位置仓库内目录的 action.yml 或独立仓库
引用uses: ./path 或 owner/repo@ref
步骤composite 的 run 必须声明 shell
对比动作=步骤级复用,工作流=作业级复用

复合动作

复合动作
# action.yml
runs:
  using: composite
  steps:
    - run: echo setup
      shell: bash
    - run: echo build
      shell: bash
输入输出用 inputs/outputs 声明:比依赖调用方预置环境变量更清晰。

易错点

  • composite 内 run 漏写 shell:校验阶段直接失败
  • 动作内假设调用方环境:显式声明依赖,保持可移植性

数据来源与参考

  • GitHub Docs《Creating a composite action》
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌