关于GitHub Action并发回退值示例中github.head_ref未定义的疑问

首先明确核心：github.head_ref是GitHub提供的上下文变量，只有在pull_request类事件触发工作流时才会被赋值（值为PR的源分支名称）。所谓「当github.head_ref未定义时」，就是指工作流被非pull_request类事件触发的场景，常见情况包括：

• 代码push到分支（比如直接推送到main分支）
• 手动触发workflow_dispatch事件
• 定时触发schedule事件
• 发布版本触发release事件

举个实际场景：如果你的工作流配置了同时响应PR和push事件：

on:
  pull_request:
  push:
    branches: [main]

当代码推送到main分支触发push事件时，GitHub不会生成github.head_ref这个变量，此时如果你的并发配置直接写concurrency: ${{ github.head_ref }}，就会因为变量不存在导致语法错误，工作流直接启动失败。

这就是官方文档要求配置回退值的原因——用类似${{ github.head_ref || github.ref_name || 'default' }}的写法，当head_ref未定义时，自动 fallback 到其他存在的变量（比如github.ref_name，所有事件都能获取到当前分支/标签名），甚至是默认字符串，避免语法错误。

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