触发可复用工作流时使用GITHUB_REF遇到的解析问题

核心问题原因 #

GitHub Actions在解析uses字段时，是工作流初始化阶段就完成的，这时候环境变量（比如$GITHUB_REF）还未生成，所以无法被解析；而使用上下文变量时，必须严格遵循语法，不能在@和${{ }}之间加空格，否则会被识别为无效的引用格式。

正确解决方案 #

1. 调用当前分支的工作流

直接使用github.ref_name上下文变量，写法要紧凑（无空格）：

uses: <my_repo>/.github/workflows/other-workflow.yml@${{ github.ref_name }}

github.ref_name会直接返回触发工作流的分支名称（比如你的<feature_branch>），GitHub会正确拉取该分支下的目标工作流文件。

2. 调用当前提交SHA对应的工作流

如果需要基于触发提交的SHA来调用工作流，用github.sha即可，同样注意无空格：

uses: <my_repo>/.github/workflows/other-workflow.yml@${{ github.sha }}

避坑提醒 #

• 不要用$GITHUB_REF这类环境变量：这类变量要到工作流运行阶段才会赋值，解析阶段无法识别，必然报错。
• 上下文变量不能加多余空格：比如@ ${{ github.sha }}（有空格）会被判定为无效引用，必须写成@${{ github.sha }}。

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