如何解决GitHub Actions中环境变量无法传递给Bash脚本的问题？

问题背景 #

你在GitHub Actions中尝试将提取到的JIRA工单ID通过环境变量传递给bash脚本，但脚本无法读取该变量，工作流无报错但未输出预期内容。

核心问题 #

你的prepare任务运行在Windows自托管Runner上，GitHub Actions在Windows环境下默认使用PowerShell作为执行Shell：

1. PowerShell通过$GITHUB_ENV设置的环境变量，不会自动同步到bash子进程的环境中
2. 直接调用.sh脚本时，Windows可能未使用bash解析执行，导致变量无法读取

解决方法 #

方法1：显式用bash执行脚本并传递变量 #

在调用脚本的步骤中，直接通过bash命令执行，并显式传入环境变量：

- name: Test script
  run: bash -c "JIRA_TICKET_ID=${{needs.extract.outputs.output}} ./scripts/deployment/test-script.sh"

方法2：将步骤切换为bash环境执行 #

把设置环境变量和执行脚本的步骤都指定为bash Shell，这样环境变量会在bash上下文直接生效：

- name: Set environment variables
  shell: bash
  run: |
    echo "JIRA_TICKET_ID=${{needs.extract.outputs.output}}" >> $GITHUB_ENV
- name: Test script
  shell: bash
  run: ./scripts/deployment/test-script.sh

方法3：在PowerShell中手动导出变量给bash #

如果需要保留PowerShell作为默认Shell，可以先在PowerShell中将变量导出为bash可识别的形式，再执行脚本：

- name: Set environment variables for bash
  run: |
    echo "JIRA_TICKET_ID=${{needs.extract.outputs.output}}" | Out-File -FilePath $env:GITHUB_ENV -Append -Encoding utf8
- name: Test script
  run: bash ./scripts/deployment/test-script.sh

额外验证步骤 #

1. 查看extract任务的日志，确认JIRA_TICKET_ID已被正确提取并输出到GITHUB_OUTPUT
2. 检查Windows Runner是否已安装bash（如Git Bash），确保bash命令在PowerShell中可正常调用

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