如何将Github Actions环境变量注入脚本以获取GITHUB_REF值

方法1：step级env声明（最稳妥，全平台兼容） #

直接通过GitHub Actions的env字段将内置上下文变量注入到当前步骤的环境变量中，无需在命令行手动拼接：

steps:
  # 前置的checkout、安装依赖等步骤省略
  - name: 运行pact consumer测试
    env:
      GITHUB_REF: ${{ github.ref }}
      CI: true
    run: yarn test:pact:consumer

这种方式不受运行器shell类型（bash/powershell等）的影响，变量会在步骤执行前完成替换，稳定性最高。

方法2：写入全局环境变量文件（多步骤共享场景） #

如果需要在后续多个步骤中都使用该变量，可以写入GitHub Actions内置的环境变量文件：

- run: echo "GITHUB_REF=${{ github.ref }}" >> $GITHUB_ENV
# 后续所有步骤都可以直接读取到GITHUB_REF环境变量
- run: CI=true yarn test:pact:consumer

注：如果使用Windows运行器，写入环境变量的命令需改为echo "GITHUB_REF=${{ github.ref }}" >> $env:GITHUB_ENV

原有写法失效的原因 #

你之前直接在命令行拼接环境变量的写法只在bash类shell下生效，且依赖运行器本身的环境变量预置，部分场景下会出现变量未展开、值为空的问题。改用GitHub内置的${{ github.ref }}上下文直接注入可以彻底避免这类shell兼容问题。

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