You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

GitHub Actions所有可用上下文变量的完整官方文档在哪里查询?

问题解答

有两种公开可靠的方式可以获取GitHub Actions所有可用的上下文变量完整列表,包含深层嵌套的字段:

  • 工作流实时打印法
    你可以在需要调试的工作流中新增一个步骤,通过GitHub Actions内置的toJSON方法序列化输出完整的github上下文对象,示例代码如下:
    steps:
      - name: 打印完整github上下文
        run: echo '${{ toJSON(github) }}'
    
    运行工作流后,在该步骤的日志中就能看到当前触发事件下所有层级的可用字段,你提到的github.event.pull_request类嵌套字段都会完整展示。这种方式拿到的字段是当前触发场景下最准确的可用列表,不同触发事件对应的字段会有差异。
  • Webhook payload对照法
    github.event对象的结构和对应事件的GitHub Webhook payload完全一致,你提到的四个pull_request相关嵌套字段就是pull_request事件Webhook的标准属性,只要对照对应事件的Webhook payload结构,就能查到所有可调用的深层嵌套字段清单。

补充说明:你提到的github.event.pull_request.head.ref等四个变量是完全合法可用的,仅在工作流触发事件为pull_request相关类型时存在,非pull_request触发的工作流不会加载这些字段,使用时可以增加条件判断避免空值报错。

内容的提问来源于stack exchange,提问作者Daniel Goldfarb

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.09.25 10:45:10