GitHub可复用工作流引用时上下文变量未被解析问题咨询

GitHub Actions 对 uses 字段的解析发生在工作流初始化的预处理阶段，该阶段仅支持解析工作流输入（inputs）、密钥（secrets）以及少量静态 github 上下文值，github.repository、github.sha 这类运行时才能确定的上下文变量，在预处理阶段尚未完成赋值，因此无法直接在 uses 字段中使用。环境变量仅在作业运行时的 runner shell 作用域内生效，更无法在预处理阶段被识别，所以你尝试的环境变量写法也不会生效。

方案1：同仓库调用场景（最优解） #

如果你调用的可复用工作流与当前工作流属于同一个仓库，不需要填写仓库名与引用标签，直接写工作流相对路径即可：

jobs:
  call-build-and-test:
    uses: .github/workflows/cicd-build-and-test.yml

该写法默认会使用触发当前工作流的提交对应的工作流文件版本，完全匹配你需要使用当前分支对应版本、不硬编码分支/提交哈希的需求，即使工作流还未合并到主分支也可以正常运行。

方案2：跨仓库调用场景 #

如果需要调用其他仓库的可复用工作流，可以通过「输入参数中转」的方式实现动态填充：

1. 先在当前工作流的触发配置中定义两个输入参数，将 github.repository 和 github.sha 设为默认值（输入参数在预处理阶段可被正常解析）
2. 在 uses 字段中直接使用输入参数变量
   示例配置如下：

on:
  push:
    branches: [ "**" ]
  pull_request:
    branches: [ "**" ]

inputs:
  target_repo:
    type: string
    default: ${{ github.repository }}
  target_ref:
    type: string
    default: ${{ github.sha }}

jobs:
  call-build-and-test:
    uses: ${{ inputs.target_repo }}/.github/workflows/cicd-build-and-test.yml@${{ inputs.target_ref }}
    # 跨私有仓库调用时可补充secrets传递权限
    secrets: inherit

如果上面的输入参数中转方案不满足你的场景，还可以使用两级工作流的方式：第一个工作流仅负责提取仓库、提交哈希等参数，通过GitHub API触发第二个专门用于调用可复用工作流的流水线，将参数作为输入传递即可，这种方式兼容性更强。

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