如何在GitHub Actions中从自托管Runner传递PAT环境变量给actions/checkout？

核心原因 #

GitHub Actions工作流中，with参数里直接写$GH_PAT是shell环境变量的引用方式，但Action参数需要通过GitHub Actions的环境变量上下文读取自托管Runner上的环境变量，直接使用shell语法会导致参数解析失败，Git无法获取有效认证信息，从而抛出"无法读取Username"的错误。

修复步骤 #

1. 修正checkout步骤的token引用 #

将原来的token: $GH_PAT替换为token: ${{ env.GH_PAT }}，让工作流正确读取自托管Runner上的GH_PAT环境变量：

- name: Checkout argocd repo
  uses: actions/checkout@v3
  with:
    fetch-depth: 0
    repository: leaderbet/argocd
    token: ${{ env.GH_PAT }}
    ref: master

2. 验证环境变量传递（可选） #

可在checkout步骤前添加打印步骤，确认GH_PAT已被正确加载：

- name: Verify GH_PAT exists
  run: echo "GH_PAT status: ${{ env.GH_PAT != '' }}"

3. 权限与变量校验 #

• 确保自托管Runner上的GH_PAT拥有目标仓库的读取权限（至少包含repo scope）
• 确认环境变量名无大小写错误（GitHub Actions环境变量大小写敏感）

错误细节补充 #

当使用$GH_PAT时，Action接收到的是字符串$GH_PAT而非实际PAT值，Git尝试用无效值认证，触发终端交互提示输入用户名，但工作流环境禁用了终端交互，因此报错。而GitHub Secrets通过${{ secrets.GH_PAT }}引用，属于工作流秘密上下文，解析逻辑不同，所以能正常工作。

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