Jenkins声明式流水线激活Python venv报错求助

问题根源 #

Jenkins的每个sh步骤都是独立的Shell进程，进程间环境变量不共享。你当前代码里，source venv/bin/activate只在它所在的Shell进程里生效，后续步骤（包括post阶段的deactivate）都是新进程，根本没处于虚拟环境中，自然会报错。另外服务器多Python版本共存时，要确保命令调用的是正确的Python3.11。

修正方案 #

方案1：将虚拟环境相关命令合并到同一个sh块 #

把创建虚拟环境、激活及后续执行命令放在同一个sh步骤里，保证环境变量持续生效：

pipeline {
    agent any
    stages {
        stage('Pull all changes') {
            steps {
                git branch: "master", url: "git@fancylink.git"
            }
        }
        stage('Setup venv and run tasks') {
            steps {
                sh '''
                    # 创建虚拟环境，明确指定Python3.11
                    python3.11 -m venv venv
                    # 激活虚拟环境并执行依赖安装等操作
                    source venv/bin/activate
                    pip install -r requirements.txt
                    # 这里添加其他需要在虚拟环境中执行的命令
                '''
            }
        }
    }
    post {
        always {
            # 无需执行deactivate，Shell进程结束后虚拟环境自动失效
            echo "执行清理或后续操作"
        }
    }
}

方案2：直接调用虚拟环境内的Python/Pip（无需激活） #

虚拟环境创建后，直接使用venv/bin/python和venv/bin/pip执行命令，跳过激活步骤更简洁可靠：

pipeline {
    agent any
    stages {
        stage('Pull all changes') {
            steps {
                git branch: "master", url: "git@fancylink.git"
            }
        }
        stage('Setup venv and run tasks') {
            steps {
                # 创建虚拟环境
                sh 'python3.11 -m venv venv'
                # 直接用虚拟环境内的pip安装依赖
                sh 'venv/bin/pip install -r requirements.txt'
                # 直接用虚拟环境内的Python运行脚本
                sh 'venv/bin/python your_script.py'
            }
        }
    }
}

关键注意事项 #

• 不要拆分source命令到独立sh步骤，进程隔离会导致环境变量丢失。
• 可指定Python3.11的绝对路径（比如/usr/bin/python3.11），避免服务器默认调用Python3.9引发版本问题。
• post阶段无需执行deactivate，每个sh进程结束后，虚拟环境的环境变量会自动清除。

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