GitHub Actions如何正确使用环境变量？变量调用报错排查

你踩了GitHub Actions两种变量引用语法的适用场景误区：

• $VAR/${VAR}是Shell环境变量的引用语法，仅在run:字段对应的Shell执行步骤中会被Shell解析展开，无法直接在第三方Action的with:传参块中生效——with块的参数是直接传递给Action程序的输入值，不会经过Shell解析，所以Action拿到的就是字面量字符串${APP_PATH}，自然会报找不到文件的错误。
• 你尝试的${{APP_PATH}}是GitHub Actions表达式语法，但写法有误：工作流中配置的自定义环境变量，在表达式中必须通过env上下文访问，缺少env.前缀的写法无法正确读取到变量值。

在with块中使用正确的表达式语法引用环境变量即可，修正后的相关配置如下：

env:
  APP_PATH: ${{ github.workspace }}/MyApp/Build/Applications/MyApp.app

jobs:
  build:
    runs-on: macos-latest

    steps:
      - name: Upload app
        uses: svenstaro/upload-release-action@v2
        with:
          file: ${{ env.APP_PATH }}

• 两种引用语法的适用场景区分要记牢：
  • 写run:步骤内的Shell命令时，直接用Shell风格引用即可，比如ls $APP_PATH、cp ${APP_PATH} ./output都能正常工作，这部分是Runner上的Shell程序读取注入的环境变量完成展开。
  • 给Action传with:参数、或者在工作流YAML的非run配置字段取值时，必须用GitHub Actions表达式语法${{ env.变量名 }}读取环境变量，这一步是工作流引擎在渲染YAML配置阶段完成值替换，和Shell解析无关。
• 如果修正写法后依然报文件不存在，可在上传步骤前增加一个校验步骤，确认目标文件确实生成、路径正确：

- name: Check app file
        run: ls -l $APP_PATH

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