GitHub Actions 手动输入怎么配置或排查

GitHub Actions 手动输入不显示时，优先检查两件事：工作流文件是否已经提交到仓库的默认分支，以及手动触发配置下是否正确嵌套了输入字段。配置正确后，打开仓库的 Actions 页面，选择工作流并点击 Run workflow，就能填写环境、版本等参数。

官方地址：https://docs.github.com/en/actions/how-tos/write-workflows/choose-when-workflows-run/trigger-a-workflow

手动运行的核心是让页面表单、工作流配置和本次运行日志使用同一组字段；先确认入口，再核对字段层级，最后用日志确认参数真的传入。

先确认 Run workflow 为什么没有出现

进入仓库的 Actions，在左侧选择目标工作流。如果页面只有历史运行记录，没有 Run workflow，先打开工作流文件的默认分支版本，确认顶层存在 on: workflow_dispatch:。GitHub 的手动触发要求该工作流文件存在于默认分支；只在功能分支里新建文件，通常不会立刻让默认分支的 Actions 页面出现按钮。

还要确认自己对仓库有足够的写入权限。可以先在工作流列表打开名称，再回到代码页检查文件路径是否为 .github/workflows/xxx.yml。这一步的成功状态是：工作流详情页能看到 Run workflow，并且按钮旁有 ref 或分支选择入口。

在 workflow_dispatch 下配置可填写字段

下面的示例把环境做成下拉选项，把版本保留为文本输入。注意 inputs 必须位于 workflow_dispatch 下面，不能与 jobs 同级，也不要把字段名写成表单上没有的别名。

name: Manual deploy

on:
  # 允许在 Actions 页面手动启动，并定义表单字段。
  workflow_dispatch:
    inputs:
      environment:
        description: "选择部署环境"
        required: true
        type: choice
        options:
          - staging
          - production
      version:
        description: "填写要部署的版本"
        required: true
        type: string

jobs:
  deploy:
    runs-on: ubuntu-latest
    steps:
      - name: Show selected values
        # 只输出非敏感参数，便于确认表单值是否传入。
        run: |
          echo "environment=${{ inputs.environment }}"
          echo "version=${{ inputs.version }}"
      - name: Deploy only from production selection
        # 条件表达式的字段名必须与 inputs 中的键完全一致。
        if: ${{ inputs.environment == 'production' }}
        run: echo "production deploy selected"

required 控制是否必须填写，default 可提供默认值，choice 会显示选项，boolean 适合开关。配置完成后，提交文件并回到 Actions 页面；如果输入框出现，说明 YAML 的触发器层级已经生效。

从 Actions 页面填写并验证一次运行

打开目标工作流，点击右上角 Run workflow，在 Use workflow from 或 ref 选择器中选定分支，然后填写 environment 和 version，最后点击运行按钮。提交后，新的 workflow run 会出现在运行列表中；打开它的摘要页，先核对触发分支，再进入 deploy job 查看日志。

示例中的两个 echo 只用于确认普通输入，不要照搬到密码、访问令牌或其他敏感字段。日志应能看到类似 environment=staging 和 version=v1.4.0 的非敏感值；这表示表单、事件载荷和 inputs 上下文已经连通。

输入框或参数不生效时按四层排查

入口层：没有 Run workflow，先确认文件已经在默认分支，并确认当前账号具有写入权限。结构层：输入框不出现，检查 workflow_dispatch、inputs 和每个字段的缩进，尤其是 on 下的层级。字段层：表单有值但 job 没按条件执行，检查表达式是否使用同一个字段名；布尔值和字符串也不要混用。运行层：打开本次 run 的日志，确认选择的 ref、输入值和条件判断，再判断问题是否已经进入脚本本身。

如果修改 YAML 后页面仍显示旧字段，先确认改动已经提交到默认分支，再重新打开工作流页面；不要只在本地编辑器里刷新。若生产环境不应由所有人选择，可以把生产选项从表单中移除，或在 job 条件中增加环境保护规则，把“能填写参数”和“允许部署”分成两层控制。

相关问题

为什么我写了 workflow_dispatch 还是没有 Run workflow？最常见原因是工作流文件还在功能分支，尚未进入默认分支；其次是账号没有写入权限。

inputs 和 github.event.inputs 应该用哪个？普通手动输入优先使用 inputs 上下文。官方文档说明两者内容对应，但 inputs 能保留布尔值类型，更适合条件判断。

怎样判断不是脚本本身的问题？先在 job 开头输出非敏感输入，并核对本次 run 的分支和事件；如果值正确，才继续检查后续部署脚本。