能否向可复用工作流传递可选环境变量？

针对你40个仓库复用工作流但部分仓库需要自定义非必填环境变量（关联Secrets）的场景，这里提供几个实用方案：

方案1：自定义Secret映射传入（最灵活，推荐） #

这个方案允许每个仓库按需传入需要的环境变量与对应Secret的映射，完全适配“变量名称未知、非必填”的需求。

第一步：编写可复用工作流 #

把通用的Build&Test逻辑放到组织公共仓库（比如.github/workflows/reusable-build-test.yml）：

name: Reusable Build & Test
on:
  workflow_call:
    inputs:
      custom_env_mapping:
        description: "JSON格式的环境变量名与仓库Secret名映射，例：'{\"SOME_API_KEY\": \"SOME_API_KEY\"}'"
        type: string
        required: false
        default: "{}"

jobs:
  test:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v3
      - uses: actions/setup-node@v3
        with:
          node-version: "20.x"
      - name: Install dependencies
        run: yarn
      - name: 加载自定义环境变量
        run: |
          # 解析传入的JSON映射，将Secret值写入环境变量
          echo '${{ inputs.custom_env_mapping }}' | jq -r 'to_entries[] | "\(.key)=\(.value)"' | while IFS="=" read -r key secret_name; do
            echo "$key=${{ secrets[$secret_name] }}" >> "$GITHUB_ENV"
          done
      - name: Run tests
        run: yarn test

第二步：在仓库中调用工作流 #

• 需要自定义变量的仓库：传入映射JSON，同时开启secrets: inherit让可复用工作流访问当前仓库的Secrets

name: Build & Test
on: [push, pull_request]

jobs:
  call-reusable:
    uses: your-org/.github/workflows/reusable-build-test.yml@main
    with:
      custom_env_mapping: '{"SOME_API_KEY": "SOME_API_KEY"}'
    secrets: inherit

• 不需要自定义变量的仓库：直接调用，无需额外参数

name: Build & Test
on: [push, pull_request]

jobs:
  call-reusable:
    uses: your-org/.github/workflows/reusable-build-test.yml@main

方案2：仓库级环境组（适合有固定自定义变量的仓库） #

如果部分仓库有固定的测试用环境变量，可以用GitHub的环境组来批量管理：

调整可复用工作流 #

name: Reusable Build & Test
on:
  workflow_call:
    inputs:
      test_environment:
        type: string
        required: false
        default: ""

jobs:
  test:
    runs-on: ubuntu-latest
    # 指定环境后，该环境的Secrets会自动注入
    environment: ${{ inputs.test_environment }}
    steps:
      - uses: actions/checkout@v3
      - uses: actions/setup-node@v3
        with:
          node-version: "20.x"
      - name: Install dependencies
        run: yarn
      - name: Run tests
        run: yarn test

调用时指定环境 #

在需要自定义变量的仓库中，先在「Settings -> Environments」创建环境并添加Secrets，然后调用时指定环境：

name: Build & Test
on: [push, pull_request]

jobs:
  call-reusable:
    uses: your-org/.github/workflows/reusable-build-test.yml@main
    with:
      test_environment: "test-env"
    secrets: inherit

方案3：自动加载前缀匹配的Secrets（零配置） #

如果能统一约定测试用Secret的命名前缀（比如TEST_），可以让工作流自动读取这些Secret并转为环境变量：

可复用工作流实现 #

name: Reusable Build & Test
on:
  workflow_call:

jobs:
  test:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v3
      - uses: actions/setup-node@v3
        with:
          node-version: "20.x"
      - name: Install dependencies
        run: yarn
      - name: 自动加载测试用Secret
        run: |
          # 遍历所有以TEST_开头的Secret，去掉前缀后作为环境变量名
          for secret in "${!TEST_@}"; do
            env_var_name="${secret#TEST_}"
            echo "$env_var_name=${!secret}" >> "$GITHUB_ENV"
          done
      - name: Run tests
        run: yarn test

比如仓库中创建TEST_SOME_API_KEY的Secret，工作流会自动将其设置为SOME_API_KEY环境变量，无需任何配置。

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