Azure自托管Windows代理Python环境配置异常求助

问题根源 #

核心问题是UsePythonVersion@0任务未正确配置环境变量，导致pip安装路径异常，手动设置PYTHONHOME/PYTHONPATH反而干扰了Python的自动路径检测。以下是分步解决方案：

1. 正确配置UsePythonVersion@0任务 #

明确指定版本、架构并强制将Python环境加入PATH，确保代理能识别正确的Python路径：

- task: UsePythonVersion@0
  inputs:
    versionSpec: '3.12.7'
    architecture: 'x64'
    addToPath: true  # 强制将Python目录及Scripts目录加入当前会话PATH

2. 重新初始化pip并修复路径 #

直接调用目标Python的绝对路径执行初始化，避免工作目录或环境变量干扰：

# 用Python安装目录的绝对路径执行ensurepip，确保安装到正确路径
<<agent_home>>\_work\_tool\Python\3.12.7\x64\python.exe -m ensurepip --default-pip
# 升级pip到最新版本
<<agent_home>>\_work\_tool\Python\3.12.7\x64\python.exe -m pip install --upgrade pip
# 手动将Python的Scripts目录加入当前会话PATH
$env:PATH = "<<agent_home>>\_work\_tool\Python\3.12.7\x64\Scripts;$env:PATH"

3. 修复"Could not find platform independent libraries "错误 #

• 禁止手动设置PYTHONHOME：该变量会覆盖Python的自动路径检测逻辑，导致核心库无法被识别。
• 验证当前Python路径是否正确：

  where python
  

  输出必须指向<<agent_home>>\_work\_tool\Python\3.12.7\x64\python.exe

4. 验证环境并安装依赖 #

执行以下命令确认pip正常工作，之后即可安装脚本依赖：

# 验证pip版本
python -m pip --version
# 安装依赖（假设存在requirements.txt）
python -m pip install -r requirements.txt

完整Pipeline示例片段 #

- task: UsePythonVersion@0
  inputs:
    versionSpec: '3.12.7'
    architecture: 'x64'
    addToPath: true

- script: |
    python -m ensurepip --default-pip
    python -m pip install --upgrade pip
  displayName: 'Initialize and upgrade pip'

- script: |
    python -m pip install -r requirements.txt
  displayName: 'Install Python dependencies'

- script: |
    # 执行你的Python脚本
    python your_script.py
  displayName: 'Run Python script'

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