GitHub Actions环境变量配置问题：读取失败与跨Job赋值困惑

第一个问题：当前步骤echo环境变量无输出的原因 #

GitHub Actions中，写入$GITHUB_ENV的环境变量不会在当前步骤立即生效。Runner会在当前步骤执行完毕后，才会读取$GITHUB_ENV文件并将变量加载到环境中。因此你在同一个步骤里执行echo ${{ env.BRANCH_NAME }}时，这个环境变量还没被加载，自然没有输出。

验证方法 #

• 如果要在当前步骤确认变量值，直接打印shell本地变量即可：

  echo $BRANCH_NAME
  

• 如果要验证环境变量是否生效，把echo放到下一个独立步骤：

  steps:
    - name: setup env variable
      run: |
        BRANCH_NAME=`echo "${{github.head_ref}}"`
        echo "BRANCH_NAME=$BRANCH_NAME" >> $GITHUB_ENV
    - name: check env variable
      run: echo ${{ env.BRANCH_NAME }}
  

这样第二个步骤就能正常输出分支名称了。

第二个问题：跨Job共享变量的正确方式 #

你尝试修改全局env段的变量是行不通的——全局env属于静态配置，运行时无法修改。要在多个Job之间共享变量，必须使用Job Outputs机制，不需要预先定义空占位符。

具体配置示例 #

name: CI
on:
  pull_request:
    branches:
      - main

jobs:
  test-job:
    runs-on: ubuntu-latest
    name: test-job
    # 定义当前Job的输出变量
    outputs:
      branch_name: ${{ steps.set_branch.outputs.branch_name }}
    steps:
      - name: setup branch variable
        id: set_branch
        run: |
          BRANCH_NAME="${{ github.head_ref }}"
          # 将变量写入GITHUB_OUTPUT，供Job outputs使用
          echo "branch_name=$BRANCH_NAME" >> $GITHUB_OUTPUT

  # 依赖test-job的后续Job
  another-job:
    runs-on: ubuntu-latest
    name: another-job
    # 声明依赖，确保test-job执行完成
    needs: test-job
    steps:
      - name: use shared variable
        run: echo "共享的分支名称：${{ needs.test-job.outputs.branch_name }}"

关键要点 #

1. 输出变量的Job必须定义outputs字段，关联步骤的输出。
2. 设置变量的步骤需要指定id，方便在outputs中引用。
3. 后续Job通过needs字段依赖输出变量的Job，然后用needs.<job-id>.outputs.<variable-name>获取变量值。

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