GitHub可复用工作流：如何引用最新提交（或分支头部）的工作流而非硬编码分支名/发布版本？

首先得说清楚为什么你之前的写法会报错：GitHub Actions在解析工作流文件的初始化阶段就会处理uses字段，这个时候像${{ github.sha }}这类上下文变量还没被插值，所以GitHub会把${{GITHUB_SHA}}当作字面量的引用字符串，自然找不到对应的分支、标签或提交，就会抛出你看到的错误。

针对同一仓库内的可复用工作流调用，有两个简单的解决方案：

方案1：使用相对路径引用（推荐，最简洁） #

当被调用工作流和调用工作流在同一个仓库时，你完全可以省略完整的仓库路径和@后面的引用，直接用相对路径指向被调用工作流文件。此时GitHub Actions会自动使用调用工作流所在的提交SHA来加载被调用工作流——这正好是你想要的“最新提交”（毕竟调用和被调用工作流在同一个提交里）。

示例代码：

jobs:
  invoke-reusable-workflow:
    uses: ./.github/workflows/called-workflow.yml
    # 这里可以正常添加with、secrets等参数
    with:
      some-input: "value"

方案2：显式绑定当前分支（适用于需要固定分支的场景） #

如果你希望明确指定使用当前分支的最新提交（比如你的工作流是在分支上运行，而非标签或特定提交），可以用@${{ github.ref_name }}来指定分支名。不过要注意，这种方式会拉取分支的最新提交，而非调用工作流所在的特定提交——如果你的分支在工作流运行期间有新提交，可能会导致版本不一致。

示例代码：

jobs:
  invoke-reusable-workflow:
    uses: ./.github/workflows/called-workflow.yml@${{ github.ref_name }}

为什么不推荐直接用@${{ github.sha }}？ #

正如你遇到的问题，uses字段的解析时机早于上下文变量的可用时机，所以GitHub无法识别这个变量，会把它当作无效的引用字符串。只有静态的分支名、标签名或完整的SHA值才能被uses字段正确解析。

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