GITHUB_REPOSITORY与github.repository在GitHub Action中的区别是什么

二者核心取值完全一致，仅在适用场景、调用方式上存在差异： #

取值规则 #

两个变量的取值没有任何区别，统一返回当前工作流所属仓库的标识，格式为仓库所有者/仓库名，比如torvalds/linux，取值逻辑完全对齐。 #

使用方式差异 #

GITHUB_REPOSITORY #

• 属于GitHub默认注入到运行器环境的环境变量，仅能在运行器的脚本/命令行执行上下文调用
• 不同操作系统的调用语法不同：
  • Linux/macOS 运行器：使用$GITHUB_REPOSITORY读取
  • Windows 运行器：使用$env:GITHUB_REPOSITORY读取
• 适用场景：直接在run字段的命令、脚本中调用，示例：

  steps:
    - name: 输出当前仓库名
      run: echo "当前仓库为 $GITHUB_REPOSITORY"
  

github.repository #

• 属于GitHub Actions内置的上下文对象属性，仅能在工作流YAML的表达式语法中调用
• 调用时必须包裹在${{ }}表达式标记内，无法直接在脚本中识别
• 适用场景：YAML字段赋值、工作流条件判断、步骤入参设置等YAML层面的逻辑处理，示例：

  # 工作流条件判断场景
  if: ${{ github.repository == 'your-username/your-repo' }}
  steps:
    - name: 用上下文传递仓库名
      run: echo "当前仓库为 ${{ github.repository }}"
  

常见使用误区 #

• 禁止混用调用方式：在YAML表达式中写${{ GITHUB_REPOSITORY }}、或者在shell脚本中直接写github.repository都会返回空值或触发报错
• 如果需要将上下文值传递给脚本使用，除了直接在run字段内插值，也可以手动绑定到自定义环境变量后调用：

  steps:
    - name: 绑定上下文到环境变量
      env:
        CURRENT_REPO: ${{ github.repository }}
      run: echo "当前仓库为 $CURRENT_REPO"
  

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