Jenkins：如何将更新后的变量传递至另一阶段的共享库函数

在声明式Jenkins Pipeline中，environment块定义的变量实际挂载在全局env对象下。你在stage的script块中修改TF_WORK_DIR = "file"，本质是更新了env.TF_WORK_DIR的值，但共享库函数中直接使用${TF_WORK_DIR}时，并不会自动关联到pipeline的env上下文，而是取到了变量的初始字面量值，导致输出不符合预期。

方案1：调用函数时传递变量作为参数 #

这是最直观且推荐的方式，将更新后的变量值显式传给共享库函数：

修改Jenkinsfile中的函数调用 #

@Library('shared-library')_

pipeline {
  agent any
  environment {
    TF_WORK_DIR = '.'
  }

  stages {
    stage('Set-Environment') {
      steps {
        script {
          println("----------------------------Init Script-----------------------------")
          TF_WORK_DIR = "file"
        }
      }
    }

    stage('Init') {
      steps {
        script{
          println("TF_WORK_DIR in init is ${TF_WORK_DIR}")
          if (TF_WORK_DIR != ".") {   
            println("TF_WORK_DIR in if condition init is ${TF_WORK_DIR}")
            function(TF_WORK_DIR) // 传递更新后的变量
          } else {
            println("TF_WORK_DIR in else condition init is ${TF_WORK_DIR}")
            function(TF_WORK_DIR) // 传递更新后的变量
          }      
        }
      }
    }
  }
}

修改共享库函数 #

def call(String tfWorkDir, timeoutMinutes = 10) {
  try {
    echo "TF_WORK_DIR inside function ${tfWorkDir}"
  } catch (Exception e) {
    currentBuild.result = 'FAILURE'
    echo "An error occurred: ${e.getMessage()}\n"
  }
}

方案2：在共享库函数中直接访问env对象 #

如果不想传递参数，可以在函数中通过全局env对象获取最新的变量值：

修改共享库函数 #

def call(timeoutMinutes = 10) {
  try {
    echo "TF_WORK_DIR inside function ${env.TF_WORK_DIR}" // 明确引用env对象
  } catch (Exception e) {
    currentBuild.result = 'FAILURE'
    echo "An error occurred: ${e.getMessage()}\n"
  }
}

你之前尝试在pipeline外部定义全局变量无效，是因为共享库函数的作用域与pipeline全局作用域相互隔离，无法直接访问到pipeline外部定义的变量。上述两种方案都能有效解决变量传递问题，其中方案1的耦合度更低，更符合代码复用的设计原则。

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