如何在GitHub Actions中实现push时设置环境变量？

GitHub Actions本身没有GitLab CI那种通过git push -o直接传递环境变量的原生推送选项，但可以通过以下几种替代方案实现类似效果：

1. 利用提交信息嵌入自定义变量 #

在提交信息中添加键值对格式的变量，然后在Workflow中提取这些变量并注入到环境中：

推送命令示例 #

git commit -m "feat: 完成用户模块开发 MAX_RETRIES=10 MAX_TIME=600"
git push

Workflow配置示例 #

jobs:
  build-and-test:
    runs-on: ubuntu-latest
    steps:
      - name: 拉取代码
        uses: actions/checkout@v4
        with:
          fetch-depth: 2 # 确保能获取最新提交信息

      - name: 提取提交信息中的变量
        run: |
          # 获取最新提交的完整信息
          COMMIT_MESSAGE=$(git log --format=%B -n 1 HEAD)
          # 匹配所有KEY=VALUE格式的条目并写入环境变量
          while IFS='=' read -r key value; do
            echo "$key=$value" >> "$GITHUB_ENV"
          done < <(echo "$COMMIT_MESSAGE" | grep -oE '[A-Z_]+=[^[:space:]]+')

      - name: 使用提取的变量
        run: |
          echo "最大重试次数: $MAX_RETRIES"
          echo "最大超时时间: $MAX_TIME"
          # 这里可以加入依赖变量的业务逻辑

2. 使用Git Notes传递变量 #

通过Git的Notes功能给提交附加变量信息，Workflow中读取Notes内容来设置环境变量：

推送命令示例 #

# 给当前HEAD提交添加包含变量的Notes
git notes add -m "MAX_RETRIES=10;MAX_TIME=600" HEAD
# 推送Notes到远程仓库
git push origin refs/notes/*
git push

Workflow配置示例 #

jobs:
  deploy:
    runs-on: ubuntu-latest
    steps:
      - name: 拉取完整代码及Notes
        uses: actions/checkout@v4
        with:
          fetch-depth: 0 # 需要完整克隆才能获取Git Notes

      - name: 从Git Notes提取变量
        run: |
          # 获取当前提交的Notes内容
          NOTES_CONTENT=$(git notes show HEAD 2>/dev/null || echo "")
          # 分割变量并写入环境
          IFS=';' read -ra VARS <<< "$NOTES_CONTENT"
          for var in "${VARS[@]}"; do
            [[ -n $var ]] && echo "$var" >> "$GITHUB_ENV"
          done

      - name: 执行部署任务
        run: |
          echo "使用变量部署: MAX_RETRIES=$MAX_RETRIES, MAX_TIME=$MAX_TIME"

3. 手动触发Workflow时传递变量（半替代方案） #

如果是手动操作场景，可以先用GitHub CLI触发Workflow并传递变量，再推送代码：

# 触发指定Workflow并传递变量
gh workflow run deploy.yml -f MAX_RETRIES=10 -f MAX_TIME=600
# 推送代码
git push

这种方式需要Workflow配置支持手动触发（添加workflow_dispatch触发器）：

on:
  push:
    branches: [main]
  workflow_dispatch:
    inputs:
      MAX_RETRIES:
        description: '最大重试次数'
        required: true
        default: '3'
      MAX_TIME:
        description: '最大超时时间'
        required: true
        default: '300'

内容的提问来源于stack exchange，提问作者Mir-Ismaili