GitHub Action中能否在uses块中替换环境变量或上下文变量？

你这种用上下文变量（比如${{ github.ref_name }}）动态引用同仓库工作流的做法确实不可行，这也是很多人在复用工作流时会踩的坑。

为什么行不通？ #

GitHub Actions在解析工作流文件的阶段（也就是工作流被触发之前）就需要确定要引用的工作流版本，而github.ref_name这类上下文变量是在工作流运行时才会被解析的。这就导致解析阶段变量还没生效，GitHub找不到你指定的工作流文件，自然就无法触发执行。

替代解决方案 #

想要避免模板重复，你可以试试这两种方法：

1. 分支条件匹配+固定版本引用

如果需要针对main和dev分支分别调用对应分支的工作流，可以用条件判断来拆分任务：

name: deploy

on:
  push:
    branches:
      - 'dev'
      - 'main'

jobs:
  run-workflow-main:
    if: github.ref_name == 'main'
    uses: MyRepo/.github/workflows/some-other-workflow.yml@main
  run-workflow-dev:
    if: github.ref_name == 'dev'
    uses: MyRepo/.github/workflows/some-other-workflow.yml@dev

这种方式虽然多写了几个任务，但能保证每个分支都调用对应版本的工作流，逻辑清晰且能正常生效。

2. 使用工作流模板（Workflow Templates）

把通用的工作流逻辑抽成模板文件（比如放在.github/workflow-templates/目录下），然后在你的deploy.yml和其他工作流文件中直接引用模板内容，而不是通过uses调用整个工作流。比如：

模板文件.github/workflow-templates/deploy-steps.yml：

steps:
  - name: Checkout code
    uses: actions/checkout@v4
  - name: Deploy to server
    run: |
      # 你的部署命令

然后在deploy.yml中引用：

name: deploy

on:
  push:
    branches:
      - 'dev'
      - 'main'

jobs:
  deploy-job:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout code
        uses: actions/checkout@v4
      - name: Load deployment steps
        uses: actions/checkout@v4
        with:
          repository: MyRepo
          ref: ${{ github.ref_name }}
          path: .github/workflow-templates
      - name: Run deployment steps
        uses: ./.github/workflow-templates/deploy-steps.yml

这种方式能真正做到逻辑复用，而且可以动态拉取对应分支的模板内容。

总结 #

目前GitHub Actions还不支持在uses字段中使用上下文变量动态指定工作流版本，所以你之前的写法无法生效。通过上面两种方案，既能避免代码重复，又能实现分支对应的工作流复用需求。

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