如何将GitHub仓库环境变量传递至可复用工作流？

可能的原因及解决方法 #

1. 调用工作流时未关联目标环境 #

环境级变量（如你在DEV/QA/PROD环境中定义的a、b）需要在调用工作流的Job中明确指定environment字段，否则vars上下文只会读取仓库级变量，无法获取对应环境的变量值。

修改调用配置，添加环境关联：

jobs:
  call-workflow-passing-data:
    uses: octo-org/example-repo/.github/workflows/reusable-workflow.yml@main
    environment: DEV # 根据实际运行环境替换为DEV/QA/PROD
    with:
      config-path: .github/labeler.yml
      deploy-a: ${{ vars.a }}
      deploy-b: ${{ vars.b }}
    secrets:
      envPAT: ${{ secrets.envPAT }}

2. 可复用工作流未正确声明输入参数 #

目标可复用工作流必须在workflow_call事件中显式声明接收的输入参数，否则无法通过${{ inputs.deploy-a }}获取值。检查reusable-workflow.yml是否包含以下配置：

on:
  workflow_call:
    inputs:
      config-path:
        required: true
        type: string
      deploy-a:
        required: true # 根据需求设置是否必填
        type: string
      deploy-b:
        required: true
        type: string
    secrets:
      envPAT:
        required: true

3. 变量名称/上下文引用错误 #

• 确认环境中定义的变量名与vars.a、vars.b完全匹配（GitHub变量名大小写不敏感，但建议严格一致避免意外）。
• 检查${{ inputs.deploy-a }}中的输入名称是否与调用时的deploy-a完全一致，包括连字符、大小写。

4. 变量权限与可见性验证 #

• 确认环境变量是在当前仓库的对应环境（DEV/QA/PROD）中定义的，而非其他仓库或组织级环境（若为组织级变量，需确保当前仓库已被授权访问）。
• 检查变量是否被设置为“受保护”，若为受保护变量，需确保运行工作流的分支/标签符合受保护规则。

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