如何为GitHub Action输入参数创建类似分支选择的下拉列表

你可以通过手动触发事件workflow_dispatch的inputs配置项，声明choice类型的输入参数实现下拉选择效果，配置方式如下：

基础配置示例 #

在你的工作流yaml文件中添加以下配置：

name: 带下拉选择参数的工作流
on:
  # 手动触发事件
  workflow_dispatch:
    inputs:
      # 自定义参数名：部署环境
      deploy_environment:
        description: "选择要部署的目标环境"
        required: true
        # 声明类型为choice，GitHub会自动渲染为下拉选择器
        type: choice
        # 下拉选项列表
        options:
          - development
          - test
          - staging
          - production
        # 默认选中的选项
        default: development
      # 可配置多个下拉参数
      node_version:
        description: "选择Node.js运行版本"
        required: true
        type: choice
        options:
          - "16.x"
          - "18.x"
          - "20.x"
        default: "18.x"

jobs:
  deploy:
    runs-on: ubuntu-latest
    steps:
      - name: 输出选中的参数
        run: |
          echo "部署环境：${{ inputs.deploy_environment }}"
          echo "Node版本：${{ inputs.node_version }}"

配置说明 #

• type: choice 是实现下拉选择的核心字段，只有配置该类型时，GitHub Action运行页才会将该输入渲染为和分支选择器一致的下拉交互组件
• options数组为下拉列表的所有可选值，支持字符串、数字格式，纯数字、含特殊字符的选项建议加引号避免YAML解析异常
• required设为true时，必须选中一个选项才能触发工作流
• default可配置默认选中的选项，无需每次手动选择

注意事项 #

• 下拉选择参数仅支持workflow_dispatch手动触发的工作流，push、定时触发等其他事件不支持该配置
• 单个choice类型输入最多支持256个选项，选项过多时建议改用普通输入框配合脚本校验
• 选项值需要提前写在工作流YAML文件中，暂不支持动态生成选项

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