Jenkins测试阶段设置Python alias不生效如何切换默认Python版本

你写的alias配置不生效是必然的，核心原因有两个：

1. Jenkins的sh步骤默认启动非交互式shell，这类shell默认关闭alias展开功能，哪怕你声明了别名，shell本身也不会识别。就算手动加shopt -s expand_aliases打开展开开关，也只能让当前shell内直接执行的命令识别别名。
2. alias是shell进程的内部配置，不会传递给子进程：你调用的check_python_version.sh、runtests.sh都是单独启动的子shell进程，完全拿不到父shell里设置的别名，最终还是会走PATH里默认找到的Python 3.8。

靠别名切换Jenkins流水线里的Python版本完全走不通，换下面几个可落地的方案即可。

方案1：临时软链接+PATH优先级（最推荐，无权限要求，全场景兼容） #

原理是在每个阶段的工作目录下建临时bin目录，给目标版本的Python、pip建软链接，再把临时目录加到PATH最前面。PATH是环境变量，会自动传递给所有子脚本，且不需要root权限，也不会修改容器的全局配置，阶段之间完全隔离。
修改后的Jenkinsfile片段参考：

stage ('Test Python 3.10') {
    steps {
        sh ''' 
        # 创建临时bin目录
        mkdir -p .tmp_bin
        # 绑定对应版本的软链接
        ln -sf /usr/local/bin/python3.10 .tmp_bin/python3
        ln -sf /usr/local/bin/pip3.10 .tmp_bin/pip3
        # 把临时目录放到PATH最前面，优先命中
        export PATH="$(pwd)/.tmp_bin:$PATH"
        # 验证版本（可选）
        which python3
        python3 --version
        # 执行测试
        scripts/check_python_version.sh 3.10 && scripts/runtests.sh
        '''
    }
}
stage ('Test Python 3.9') {
    steps {
        sh ''' 
        mkdir -p .tmp_bin
        ln -sf /usr/local/bin/python3.9 .tmp_bin/python3
        ln -sf /usr/local/bin/pip3.9 .tmp_bin/pip3
        export PATH="$(pwd)/.tmp_bin:$PATH"
        scripts/check_python_version.sh 3.9 && scripts/runtests.sh
        '''
    }
}
stage ('Test Python 3.8') {
    steps {
        sh ''' 
        mkdir -p .tmp_bin
        ln -sf /usr/local/bin/python3.8 .tmp_bin/python3
        ln -sf /usr/local/bin/pip3.8 .tmp_bin/pip3
        export PATH="$(pwd)/.tmp_bin:$PATH"
        scripts/check_python_version.sh 3.8 && scripts/runtests.sh
        '''
    }
}

注：每个sh步骤都是独立的shell进程，所以每个阶段都要重新配置软链接和PATH，不会出现版本串扰。临时目录.tmp_bin会随Jenkins工作区清理自动删除，不需要手动处理。

方案2：显式指定解释器环境变量（适合脚本支持自定义Python路径的场景） #

如果你自己写的check_python_version.sh、runtests.sh内部支持通过环境变量指定Python路径（比如读取PYTHON变量调用解释器），可以直接在阶段里声明环境变量，不需要建软链接：

stage ('Test Python 3.10') {
    steps {
        sh ''' 
        export PYTHON=/usr/local/bin/python3.10
        export PIP=/usr/local/bin/pip3.10
        scripts/check_python_version.sh 3.10 && scripts/runtests.sh
        '''
    }
}

如果脚本里是硬编码调用python3命令，这个方法不生效，选方案1即可。

方案3：update-alternatives全局切换（适合容器以root运行的场景） #

如果你的Docker容器运行用户是root，可以用系统自带的update-alternatives工具全局切换Python版本，切换后所有进程都会用到指定版本：

stage ('Test Python 3.10') {
    steps {
        sh ''' 
        # 注册3.10版本到alternatives列表
        update-alternatives --install /usr/local/bin/python3 python3 /usr/local/bin/python3.10 10
        update-alternatives --install /usr/local/bin/pip3 pip3 /usr/local/bin/pip3.10 10
        # 切换当前版本为3.10
        update-alternatives --set python3 /usr/local/bin/python3.10
        update-alternatives --set pip3 /usr/local/bin/pip3.10
        # 执行测试
        scripts/check_python_version.sh 3.10 && scripts/runtests.sh
        '''
    }
}

注：如果你的流水线是复用同一个运行中的容器（不是每个阶段启动新容器），每个阶段都必须重新执行--set命令切换版本，避免上一个阶段的配置残留。

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