如何在GitHub Workflow中通过输入定义uses部分的分支名？

你遇到的核心问题是引用输入变量的路径错误，直接写branch_name无法被GitHub Actions识别，得用正确的上下文变量路径调用workflow_dispatch的输入值。

正确写法 #

把uses字段里的${{ branch_name }}替换成${{ github.event.inputs.branch_name }}，完整代码示例：

jobs:
  deploy_gcp:
    name: Deploy to <test cluster>
    if: ${{ contains('["<user 1>", "<user 2>"]', github.actor) }}
    needs:
      - helm
      - docker
    uses: "<main folder>/<repo name>/.github/workflows/deploy.yaml@${{ github.event.inputs.branch_name }}"
    with:
      cloud: gcp
      cluster_name: <>
      <product>_region: <>
      region: <>
      dry_run: false
      gcp_service_account: <>
      gcp_project: <>
      slack_channel: <>
      database_version: <>
    secrets:
      <some secrets>

之前写法失败的原因 #

• 直接写${{ branch_name }}时，GitHub Actions找不到这个变量，会把它当成原始字符串处理，导致版本部分格式无效，触发报错。
• 用双引号包裹后虽然不报错，但变量依然没被正确解析，执行时会找不到对应分支的workflow文件，最终执行失败。

补充注意事项 #

• 触发Workflow时输入的branch_name必须是目标仓库真实存在的分支，否则会出现“找不到workflow文件”的错误。
• 你已经在on.workflow_dispatch.inputs.branch_name里设置了default: main，触发时不修改输入值的话，会默认使用main分支，符合你的初始需求。

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