Jenkinsfile中变量作用域异常行为的原因咨询

这个报错的核心是Groovy的变量作用域规则，结合Jenkins流水线的执行上下文来理解就清晰了：

1. 用def定义变量时的作用域问题 #

当你写def some_var = "some value"时，这个变量属于脚本局部作用域。在Groovy中，任何.groovy脚本都会被编译成一个继承自groovy.lang.Script的类，脚本里的顶层代码（不在函数内的代码）会被打包到这个类的run()方法中。

而你定义的pr()函数，是这个脚本类的成员方法，它的作用域和run()方法完全独立——run()里的局部变量（也就是用def声明的some_var），在成员方法pr()里是无法直接访问的。这就导致了MissingPropertyException，因为pr()在自身作用域和绑定上下文里都找不到some_var。

2. 去掉def后的变量作用域变化 #

当你去掉def，直接写some_var = "some value"时，这个变量会被存入Groovy的Binding上下文。Binding是Groovy脚本的全局上下文容器，所有脚本代码（包括顶层代码、自定义成员方法、甚至声明式流水线的步骤）都能访问Binding里的变量。

这时候pr()函数访问some_var时，会先在自身局部作用域查找，找不到就去Binding上下文里检索，自然能拿到变量值，脚本也就正常运行了。

额外提醒：Jenkins流水线的特殊点 #

在Jenkins流水线中，声明式流水线（即你写的pipeline {...}部分）的上下文和顶层脚本共享Binding。这意味着Binding变量不仅能在自定义函数里访问，也能直接在声明式的stage、steps中使用；但如果是用def定义的脚本局部变量，在声明式流水线的steps里同样无法直接访问，本质还是同一个作用域规则在起作用。

举个验证小例子：

// 运行会报错：some_var不在当前作用域
def some_var = "test"
pipeline {
    agent any
    stages {
        stage("Test") {
            steps {
                script {
                    echo "${some_var}" 
                }
            }
        }
    }
}

// 可以正常运行：some_var在Binding中
some_var = "test"
pipeline {
    agent any
    stages {
        stage("Test") {
            steps {
                script {
                    echo "${some_var}" 
                }
            }
        }
    }
}

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