Azure托管Ubuntu代理conda环境下Python3.7 pip安装包失败解决方案求助

问题根因说明 #

• 你配置的python.version矩阵参数仅对Azure DevOps官方的UsePythonVersion任务生效，当前你使用conda管理Python环境，该配置不会自动同步到conda环境中
• 激活conda环境后未校验当前环境的pip路径，默认调用了系统全局绑定Python3.8的pip，导致安装路径和预期环境不匹配
• setup.py的IndexError报错和Python版本冲突无直接关联，是因为代码中获取git分支信息时，返回结果的格式不符合预期，拆分后长度不足导致索引越界
• 完全不需要删除系统自带的Python3.8、Python3.9版本，通过conda环境隔离即可解决版本冲突问题

具体解决方案 #

1. 修正azure-pipelines.yml配置 #

新增conda环境创建、激活校验步骤，确保使用的是Python3.7环境下的pip：

jobs:
  - job:
    displayName: ubuntu-latest
    pool:
      vmImage: 'ubuntu-latest'
    steps:
      - bash: echo "##vso[task.prependpath]$CONDA/bin"
        displayName: Add conda to system PATH
      - bash: eval "$(conda shell.bash hook)"
        displayName: Adapt conda to bash shell environment
      - bash: conda create -n py37_env python=3.7 pip -y
        displayName: Create Python 3.7 dedicated conda environment
      - bash: |
          eval "$(conda shell.bash hook)"
          conda activate py37_env
          # 校验当前环境信息，确认符合预期
          which python
          python --version
          which pip
          pip --version
          # 执行本地包安装，优先用python -m pip避免调用错位
          python -m pip install .
        displayName: Activate environment and install local package

2. 兼容setup.py的分支获取逻辑 #

修改generate_repo_version函数中获取分支的代码，增加异常兜底逻辑，避免索引越界：

# 原错误逻辑：未判断拆分后的列表长度
# branch = line.strip().split(" ")[1]

# 修正后逻辑
line_parts = line.strip().split(" ")
if len(line_parts) >= 2:
    branch = line_parts[1]
else:
    # 自定义兜底值，避免程序直接崩溃
    branch = "default_branch"

3. 可选：固定pip调用方式 #

所有pip操作统一使用python -m pip代替直接调用pip，可以彻底避免不同环境的pip调用错位问题。

内容的提问来源于stack exchange，提问作者C.B.