如何通过命令行运行GitHub Action？解决Web-UI分支选择问题

要在命令行手动触发GitHub Action，官方推荐使用GitHub CLI（gh）工具，具体步骤如下：

• 安装并登录GitHub CLI
  先确保你的系统已安装gh工具（可通过系统包管理器或官方渠道获取）。安装完成后执行登录命令：

  gh auth login
  

  按照终端提示选择GitHub.com、HTTPS协议，完成CLI的权限授权即可。

• 触发指定工作流
  直接运行以下命令触发目标工作流，替换<工作流文件名>为你实际的工作流YAML文件名（比如ci.yml、deploy.yml）：

  gh workflow run <工作流文件名>
  

• 指定分支运行（解决Web UI分支选择问题）
  如果需要在特定分支上执行工作流，添加--ref参数指定分支名称：

  gh workflow run <工作流文件名> --ref <分支名>
  

  示例：

  gh workflow run test.yml --ref feature/new-module
  

• 带输入参数的工作流
  若你的工作流定义了workflow_dispatch输入参数，可通过--field指定参数值：

  gh workflow run deploy.yml --ref main --field environment=production --field release-version=v2.1.0
  

• 查看工作流运行状态
  触发后可通过以下命令查看运行记录和详情：

  # 查看最近的工作流运行列表
  gh run list
  # 查看某条运行的详细日志
  gh run view <运行ID>
  

关键注意事项 #

你的工作流文件必须包含workflow_dispatch触发器，否则无法通过命令行或Web UI手动触发，示例配置：

on:
  workflow_dispatch:
    inputs:
      environment:
        description: '目标部署环境'
        required: true
        default: 'staging'

内容的提问来源于stack exchange，提问作者Noam Freeman