GitHub Actions中嵌套系统环境变量无法展开的解决方法

GitHub Actions 工作流中顶层（workflow 级）、Job 级的静态env块加载时不会触发 Shell 变量展开逻辑，写入的$USER会被当做普通字符串存储，不会替换为系统环境变量的实际值，因此执行echo时会原样输出未解析的字符串。

需要动态解析系统环境变量的自定义变量，不能直接在静态env块中声明，要放到 Shell 执行阶段赋值，分两种使用场景配置：

• 仅单步骤内使用的变量：直接在对应步骤的run脚本中声明即可，Shell 执行时会自动完成变量展开

  jobs:
    run_tests:
      runs-on: ubuntu-latest
      steps:
        - name: 输出路径
          run: |
            MY_PATH="/Users/$USER/myDir/"
            echo "$MY_PATH"
  

• 需要跨多步骤复用的变量：通过 GitHub Actions 提供的$GITHUB_ENV环境文件写入变量，写入后当前 Job 下所有后续步骤都可以直接读取这个变量

  jobs:
    run_tests:
      runs-on: ubuntu-latest
      steps:
        - name: 写入全局自定义路径变量
          run: |
            echo "MY_PATH=/Users/$USER/myDir/" >> $GITHUB_ENV
        - name: 验证路径输出
          run: echo "$MY_PATH"
  

• 静态env块加载时还未进入 Shell 执行上下文，拿不到$USER/$HOME这类运行时系统变量，所有需要动态展开的变量都必须放到run脚本段中处理。
• 路径格式要匹配运行器系统：/Users/是 macOS 系统的用户目录前缀，如果你用ubuntu-latest运行器，默认用户目录在/home/runner/下，直接拼接$HOME变量写路径更通用，不会出现路径不存在的问题。

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