GitHub Actions：如何在Job级别使用环境变量？

你遇到的问题是因为GitHub Actions中，Job级别的env上下文仅指向当前Job内部定义的环境变量，无法直接访问顶层全局env。以下是几种可行的解决办法：

方法1：使用vars上下文访问顶层环境变量 #

GitHub Actions会自动将顶层env的变量注入到vars上下文中，因此可以直接在Job的if条件中使用：

env:
  stageEnv: UAT

jobs:
  Upload-Build:
    if: ${{ vars.stageEnv == 'UAT' }}
    steps:
      # 你的步骤内容

方法2：将顶层变量传递到Job级别的env中 #

先在Job内部定义一个环境变量，引用顶层的stageEnv，之后在if条件中使用Job级别的环境变量：

env:
  stageEnv: UAT

jobs:
  Upload-Build:
    env:
      job_stage_env: ${{ env.stageEnv }}
    if: ${{ env.job_stage_env == 'UAT' }}
    steps:
      # 你的步骤内容

方法3：使用工作流输入变量（适合动态场景） #

如果需要手动触发时动态指定环境，可以通过workflow_dispatch定义输入变量，这样在Job级别直接访问输入变量即可：

on:
  workflow_dispatch:
    inputs:
      stageEnv:
        description: '部署环境'
        required: true
        default: 'UAT'

jobs:
  Upload-Build:
    if: ${{ github.event.inputs.stageEnv == 'UAT' }}
    steps:
      # 你的步骤内容

补充说明 #

• 顶层env定义的变量在Steps级别可以直接用env.stageEnv访问，是因为Steps级别的env上下文包含了顶层和当前Job的所有环境变量。
• Job级别的if条件判断时，只能访问Job上下文、GitHub上下文、vars上下文等，无法直接访问顶层env，这就是你之前报错"unrecognized named-value: 'env'"的原因。

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