能否在Groovy函数中设置环境变量？Jenkins声明式管线问询

答案是不行——你没法直接在普通Groovy函数里使用Jenkins声明式Pipeline的environment块来定义环境变量，原因很简单：

environment是Jenkins声明式Pipeline专属的DSL语法元素，它只能被Jenkins的声明式解析器识别，而且只能放在pipeline根节点或者stage块内部。普通Groovy函数属于脚本式代码范畴，Jenkins不会去解析函数内部的声明式DSL语法，你如果硬写进去，要么会抛出语法错误，要么变量根本不会生效。

更优雅的替代方案：使用withEnv步骤 #

既然你觉得sh "ENV=value; some CMD"在变量多的时候可读性差，那Jenkins提供的withEnv步骤就是完美的替代方案。它可以临时将一组环境变量注入到后续步骤的执行上下文里，不管是sh还是其他Jenkins步骤都能直接使用这些变量，而且变量列表清晰易维护。

示例代码如下：

def myReusableFunction() {
    withEnv([
        'APP_NAME=my-web-app',
        'APP_VERSION=2.3.1',
        'DEPLOY_ENV=staging'
    ]) {
        // 所有在withEnv块里的步骤都能直接访问这些环境变量
        sh 'echo Deploying $APP_NAME version $APP_VERSION to $DEPLOY_ENV'
        sh './deploy-script.sh' // 脚本内部也能读取这些变量
        echo "Current env: ${env.DEPLOY_ENV}" // Groovy代码里也能通过env对象访问
    }
}

进阶：用共享库复用逻辑 #

如果这个函数需要在多个Jenkins Pipeline里复用，建议把它放到**Jenkins共享库（Shared Libraries）**的vars目录下。这样你可以在任意Pipeline里直接调用这个函数，而且变量定义和操作逻辑都封装在共享库中，便于统一维护。

举个共享库的例子（假设共享库名为myPipelineLib）：

// vars/deployApp.groovy
def call() {
    withEnv([
        'APP_NAME=my-web-app',
        'APP_VERSION=2.3.1',
        'DEPLOY_ENV=staging'
    ]) {
        sh 'echo Deploying $APP_NAME version $APP_VERSION to $DEPLOY_ENV'
        sh './deploy-script.sh'
    }
}

然后在Pipeline中调用：

@Library('myPipelineLib') _

pipeline {
    agent any
    stages {
        stage('Deploy') {
            steps {
                deployApp() // 直接调用共享库中的函数
            }
        }
    }
}

补充：如果非要贴近声明式写法？ #

如果你特别想贴近声明式environment的写法，只能在声明式stage的environment块里定义变量，然后把变量传给函数——但这样变量定义还是在stage里，没法做到在函数内部定义，所以并不符合你的需求。

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