如何基于分支设置GitHub Workflow环境变量TAG_PREFIX

首先修正你原代码里的两个问题：

• 变量名拼写错误：TAG_PREXIX 应该改为 TAG_PREFIX
• 无效变量：${{github.branch-v}} 不是GitHub Actions的合法上下文变量，正确的分支引用是 github.ref

下面提供两种可行的实现方案：

方案一：在env中直接用条件表达式设置 #

这种方式简洁，适合分支规则简单的场景，直接在全局env里通过条件判断赋值：

name: Release
on:
  push:
    branches:
      - main
      - release/*
env:
  REGISTRY: ghcr.io
  IMAGE_NAME: ${{ github.repository }}-image
  # 根据分支动态设置TAG_PREFIX
  TAG_PREFIX: ${{ startsWith(github.ref, 'refs/heads/release/') && 'release-v' || github.ref == 'refs/heads/main' && 'main-v' }}

jobs:
  Release:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout repository
        uses: actions/checkout@v3
      
      # 后续步骤可以直接使用${{ env.TAG_PREFIX }}变量
      - name: Example usage
        run: echo "当前TAG前缀是: ${{ env.TAG_PREFIX }}"

表达式说明： #

• startsWith(github.ref, 'refs/heads/release/') 判断当前分支是否属于release/*前缀（比如release/test）
• 符合条件则赋值release-v，否则判断是否是main分支，赋值main-v
• 因为你的Workflow只监听main和release/*分支，所以无需处理其他分支情况

方案二：在步骤中用shell命令设置 #

如果后续需要更复杂的分支判断逻辑，推荐用这种方式，通过shell脚本写入环境变量：

name: Release
on:
  push:
    branches:
      - main
      - release/*
env:
  REGISTRY: ghcr.io
  IMAGE_NAME: ${{ github.repository }}-image

jobs:
  Release:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout repository
        uses: actions/checkout@v3
      
      - name: Set TAG_PREFIX based on branch
        run: |
          # 根据GITHUB_REF环境变量判断分支
          if [[ "${GITHUB_REF}" == "refs/heads/main" ]]; then
            echo "TAG_PREFIX=main-v" >> $GITHUB_ENV
          elif [[ "${GITHUB_REF}" == refs/heads/release/* ]]; then
            echo "TAG_PREFIX=release-v" >> $GITHUB_ENV
          fi
      
      # 验证变量是否生效
      - name: Verify TAG_PREFIX
        run: echo "当前TAG前缀是: $TAG_PREFIX"

说明： #

• GITHUB_REF是GitHub Actions自动注入的环境变量，值为当前分支的完整引用（比如refs/heads/main或refs/heads/release/test）
• 通过echo "KEY=VALUE" >> $GITHUB_ENV的方式，可以将变量写入当前Job的环境中，后续步骤直接调用即可

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