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

GitHub Actions 手动触发

为工作流提供手动运行入口:声明输入参数(字符串、布尔、选项、环境),通过界面、API 或 CLI 触发,适合补跑与受控发布。

CI/CD 与发布速查开发更新于 2026-10-12
声明on: workflow_dispatch.inputs
类型string、boolean、choice、environment
入口界面、REST API、gh CLI
权限由仓库权限控制

带选项的手动发布

带选项的手动发布
on:
  workflow_dispatch:
    inputs:
      env:
        type: choice
        options: [staging, production]
        default: staging
jobs:
  deploy:
    runs-on: ubuntu-latest
    steps:
      - run: echo "deploy to ${{ inputs.env }}"
# CLI:gh workflow run deploy.yml -f env=staging
手动入口配合环境保护规则:默认值与审批配置共同约束误操作。

易错点

  • 输入未校验直接拼接命令:注入与选错环境两类风险
  • 默认值偏向生产:手动触发的默认项应当保守

数据来源与参考

  • GitHub Docs《Manually running a workflow》
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌