GitHub Actions Linux运行器配置PATH后kubelogin命令找不到

kubelogin: command not found报错和PATH覆盖逻辑无关，核心问题有三个：

• 单步骤内export PATH=xxx的作用域仅限当前run步骤的shell进程，步骤执行结束shell销毁后，配置的PATH就会完全失效，后续步骤无法读取到你追加的路径。你在步骤内打印PATH能看到自定义路径，只是因为echo操作和export在同一个shell进程内，不代表后续步骤能拿到这个PATH配置。
• 你之前尝试写GITHUB_PATH的写法有误，GitHub Actions中要追加跨步骤生效的PATH，必须通过$GITHUB_PATH引用运行器自动注入的环境变量对应的文件路径，直接写GITHUB_PATH只会往当前工作目录下的同名普通文件写入内容，根本不会被运行器识别为PATH配置。
• az aks install-cli的--install-location、--kubelogin-install-location参数要求传入包含文件名的二进制完整存放路径，如果传入的是目录路径，CLI会把二进制文件直接命名为你传入的目录名，后续你把这个路径当目录加到PATH里，自然找不到对应的可执行文件。

Linux运行器直接替换原有安装步骤即可：

- id: install-aks-cli
  run: |
    # 提前创建二进制存放目录，避免权限报错
    mkdir -p /home/actions/azure-kubectl-bin /home/actions/azure-kubelogin-bin
    # 安装时传入二进制完整路径，而非目录路径
    az aks install-cli \
      --install-location /home/actions/azure-kubectl-bin/kubectl \
      --kubelogin-install-location /home/actions/azure-kubelogin-bin/kubelogin
    # 给二进制添加可执行权限
    chmod +x /home/actions/azure-kubectl-bin/kubectl /home/actions/azure-kubelogin-bin/kubelogin
    # 将二进制所在目录追加到跨步骤生效的PATH中
    echo "/home/actions/azure-kubectl-bin" >> $GITHUB_PATH
    echo "/home/actions/azure-kubelogin-bin" >> $GITHUB_PATH
    # 本步骤内临时加载PATH做安装校验，提前发现问题
    export PATH="/home/actions/azure-kubectl-bin:/home/actions/azure-kubelogin-bin:$PATH"
    kubectl version --client
    kubelogin --version
    echo "AKS CLI tools (kubectl + kubelogin) installed successfully"
  shell: bash

• 所有需要跨步骤生效的PATH配置，都必须写入$GITHUB_PATH文件，不要依赖单步骤内的export操作。
• 如果你需要复用workflow input里的安装路径参数，要确保参数传入的是带二进制文件名的全路径，而非目录路径。比如${{ inputs.kube-ctl-install-location }}的取值应为/home/actions/azure-kubectl-bin/kubectl，${{ inputs.kube-login-install-location }}的取值应为/home/actions/azure-kubelogin-bin/kubelogin。
• 安装完成后在同一步骤内做版本校验，可以提前排查二进制下载失败、权限不足、路径写错的问题，不用等到后续业务步骤调用才发现工具不可用。

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