GitHub Actions Workflow中如何在uses里引用环境变量？

问题原因 #

GitHub Actions的uses字段属于作业初始化阶段解析的配置项，而全局/作业级环境变量是在作业运行阶段才会被注入的。这意味着当解析uses的时候，你定义的env.DBT_REPO还未被加载，因此会触发“Unrecognized named-value: 'DBT_REPO'”的错误。

可行解决方案 #

1. 直接引用仓库变量（最优解）

既然DBT_REPO的值来自仓库变量vars.DBT_REPO，可以跳过环境变量中转，直接在uses中引用该仓库变量：

jobs:
  your-dbt-job:
    runs-on: ubuntu-latest
    steps:
      - name: 拉取代码仓库
        uses: actions/checkout@v4
      - name: 执行dbt动作
        uses: ./${{ vars.DBT_REPO }}/dbt-action

这种方式可行的原因是，vars上下文属于GitHub Actions初始化阶段就能访问的全局上下文，解析uses时可以直接获取到变量值。

2. 动态路径的进阶处理

如果需要拼接更复杂的路径（比如结合其他固定路径片段），可以直接在uses中用表达式组合：

uses: ./actions/${{ vars.DBT_REPO }}/dbt-workflow/dbt-action

只要是初始化阶段可用的上下文（如vars、github、secrets等），都可以直接在uses的路径中使用。

注意事项 #

• 不要尝试用作业步骤输出、运行时环境变量来给uses传值，这些内容都是在作业启动后才生成的，无法被初始化阶段的uses解析。
• 如果你的路径需要基于运行时逻辑动态生成，可能需要调整工作流结构，比如先通过步骤生成路径文件，再调用本地动作时读取该文件，但这种方式不适用于uses字段本身的路径定义。

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