环境变量

关于环境变量

GitHub 设置适用于工作流程运行中每个步骤的默认环境变量。 环境变量区分大小写。 在操作或步骤中运行的命令可以创建、读取和修改环境变量。

要设置自定义环境变量，您需要在工作流程文件中指定变量。 您可以使用 jobs.<job_id>.steps[*].env、jobs.<job_id>.env 和 env 关键字定义步骤、作业或整个工作流程的环境变量。 更多信息请参阅“GitHub 的工作流程语法”。

jobs:
  weekday_job:
    runs-on: ubuntu-latest
    env:
      DAY_OF_WEEK: Mon
    steps:
      - name: "Hello world when it's Monday"
        if: ${{ env.DAY_OF_WEEK == 'Mon' }}
        run: echo "Hello $FIRST_NAME $middle_name $Last_Name, today is Monday!"
        env:
          FIRST_NAME: Mona
          middle_name: The
          Last_Name: Octocat

要在工作流程文件中使用环境变量的值，您应该使用 env 上下文。 如果要在运行器中使用环境变量的值，您可以使用运行器操作系统的正常方法来读取环境变量。

如果使用工作流程文件的 run 键从运行器操作系统中读取环境变量（如上例所示），则在作业发送到运行器后，该变量将在运行器操作系统中被替换。 对于工作流程文件的其他部分，必须使用 env 上下文来读取环境变量；这是因为工作流程键（例如 if）需要在发送到运行器之前，在工作流程处理过程中替换变量。

您也可以使用 GITHUB_ENV 环境文件 设置工作流程中的以下步骤可以使用的环境变量。 环境文件可直接由操作使用，或使用 run 关键字作为工作流程文件中的 shell 命令。 更多信息请参阅“GitHub Actions 的工作流程命令”。

默认环境变量

强烈建议操作使用环境变量访问文件系统，而非使用硬编码的文件路径。 GitHub 设置供操作用于所有运行器环境中的环境变量。

确定何时使用默认环境变量或上下文

GitHub Actions 包含一个称为上下文的变量集和一个称为默认环境变量的类似变量集。 这些变量预期用于工作流程中的不同点：

• 默认环境变量：这些变量仅存在于执行作业的运行器上。 更多信息请参阅“默认环境变量”。
• 上下文：您可以在工作流程的任何时候使用大多数上下文，包括当默认环境变量不可用时。 例如，您可以使用带表达式的上下文执行初始处理，然后将作业路由到运行器以供执行；这允许您使用带有条件 if 关键字的上下文来确定步骤是否应运行。 作业运行后，您还可以从执行作业的运行器（如 runner.os）检索上下文变量。 更多信息请参阅“上下文”。

下面的示例演示了这些不同类型的环境变量如何在一个作业中一起使用：

name: CI
on: push
jobs:
  prod-check:
    if: ${{ github.ref == 'refs/heads/main' }}
    runs-on: ubuntu-latest
    steps:
      - run: echo "Deploying to production server on branch $GITHUB_REF"

在此示例中，if 语句检查 github.ref 上下文以确定当前分支名称；如果名称是 refs/heads/main，则执行后续步骤。 if 检查由 GitHub Actions 处理，作业仅在结果为 true 时才发送到运行器。 作业发送到运行器后， 该步骤将执行并引用运行器的 $GITHUB_REF 环境变量。

环境变量命名约定

设置自定义环境变量时，不能使用上面列出的前缀为 GITHUB_ 的任何默认环境变量名称。 如果尝试重写其中一个默认环境变量的值，则会忽略赋值。

您设置的指向文件系统上某个位置的任何新环境变量都应该有 _PATH 后缀。 HOME 和 GITHUB_WORKSPACE 默认变量例外于此约定，因为 "home" 和 "workspace" 一词已经暗示位置。