如何在Windows上通过Git-Bash的Azure Pipelines步骤修改PATH环境变量？

在Azure Pipelines的Windows代理上用Git-Bash执行Bash步骤时，Git-Bash会自动把Windows风格的PATH（分号分隔、反斜杠路径）转成类Unix格式，但我们需要设置原生Windows PATH才能让后续任务正确识别工具路径。当前维护WINDOWS_PATH和PATH两个变量的方式冗余杂乱，以下是几个更简洁的解决方案：

方案1：调用Windows命令直接获取原生PATH #

Git-Bash里可以直接调用cmd.exe执行Windows原生命令，拿到未被篡改的PATH，代码最简洁：

修改后的完整步骤代码：

parameters:
  - name: tool
  - name: url
    type: object
    default:
      Linux:
      Windows_NT:
  - name: version
    default: latest

steps:
  - bash: |
      PS4='##[command]  ' ; set -euox pipefail

      tool=${{ parameters.tool }}
      version=${{ parameters.version }}

      if type $tool 2> /dev/null; then exit; fi

      if [[ $AGENT_OS == Windows_NT ]]; then
        # 调用cmd获取原生Windows PATH，去掉回车符避免格式问题
        ORIGINAL_PATH=$(cmd.exe /c "echo %PATH%" | tr -d '\r')
        # 拼接新工具路径到最前面
        NEW_PATH="$AGENT_TOOLSDIRECTORY\\$tool\\$version;$ORIGINAL_PATH"
        AGENT_TOOLSDIRECTORY=${AGENT_TOOLSDIRECTORY//\\//}
        url=${{ parameters.url.Windows_NT }}
      else
        url=${{ parameters.url.Linux }}
        NEW_PATH="$AGENT_TOOLSDIRECTORY/$tool/$version:$PATH"
      fi

      ... # 保留原有的工具下载、解压逻辑

      set +x
      # 直接设置最终PATH，无需维护额外变量
      echo "##vso[task.setvariable variable=PATH]$NEW_PATH"
    displayName: Install ${{ parameters.tool }}

方案2：从Windows注册表读取原生PATH #

如果担心cmd.exe调用的兼容性，可以直接从注册表读取系统和用户级的原生PATH：

关键代码片段替换：

if [[ $AGENT_OS == Windows_NT ]]; then
  # 读取系统级PATH
  SYSTEM_PATH=$(reg query "HKLM\SYSTEM\CurrentControlSet\Control\Session Manager\Environment" /v PATH | grep -Eo "PATH\s+REG_EXPAND_SZ\s+.+" | sed 's/PATH\s+REG_EXPAND_SZ\s+//')
  # 读取用户级PATH（忽略不存在的情况）
  USER_PATH=$(reg query "HKCU\Environment" /v PATH 2>/dev/null | grep -Eo "PATH\s+REG_SZ\s+.+" | sed 's/PATH\s+REG_SZ\s+//')
  ORIGINAL_PATH="$SYSTEM_PATH;$USER_PATH"
  NEW_PATH="$AGENT_TOOLSDIRECTORY\\$tool\\$version;$ORIGINAL_PATH"
  AGENT_TOOLSDIRECTORY=${AGENT_TOOLSDIRECTORY//\\//}
  url=${{ parameters.url.Windows_NT }}
fi

方案3：用PowerShell提前获取原生PATH #

如果Bash里处理Windows路径还是有问题，可以拆分步骤，先用PowerShell拿到原生PATH再传给Bash：

steps:
  # 先执行PowerShell获取原生PATH并设为Pipeline变量
  - powershell: |
      $systemPath = [Environment]::GetEnvironmentVariable("PATH", "Machine")
      $userPath = [Environment]::GetEnvironmentVariable("PATH", "User")
      $originalPath = "$systemPath;$userPath"
      Write-Host "##vso[task.setvariable variable=ORIGINAL_WINDOWS_PATH]$originalPath"
    displayName: Fetch Original Windows PATH
    condition: eq(variables['Agent.OS'], 'Windows_NT')

  # 原Bash步骤直接用变量
  - bash: |
      PS4='##[command]  ' ; set -euox pipefail

      tool=${{ parameters.tool }}
      version=${{ parameters.version }}

      if type $tool 2> /dev/null; then exit; fi

      if [[ $AGENT_OS == Windows_NT ]]; then
        NEW_PATH="$AGENT_TOOLSDIRECTORY\\$tool\\$version;$ORIGINAL_WINDOWS_PATH"
        AGENT_TOOLSDIRECTORY=${AGENT_TOOLSDIRECTORY//\\//}
        url=${{ parameters.url.Windows_NT }}
      else
        url=${{ parameters.url.Linux }}
        NEW_PATH="$AGENT_TOOLSDIRECTORY/$tool/$version:$PATH"
      fi

      ... # 工具下载逻辑

      set +x
      echo "##vso[task.setvariable variable=PATH]$NEW_PATH"
    displayName: Install ${{ parameters.tool }}

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