Jenkins自定义函数是否始终以Groovy语法执行？及机制问询

核心差异：声明式DSL vs 脚本式Groovy #

Jenkins的声明式Pipeline是一套结构化的领域特定语言（DSL），它有严格的语法规则和预定义结构，目的是让Pipeline更规范、易维护。在pipeline{}块内部，所有代码都要遵循声明式的规则：

• 必须使用固定的层级结构（比如agent、stages、stage、steps等）
• 不允许直接使用Groovy的动态语法，比如用变量作为stage名称、直接写for循环
• 执行前会先做语法校验，不符合规则的代码直接报错

而脚本式Groovy（包括声明式外的自定义函数、script{}块内的代码）完全遵循Groovy语法，没有这些限制，Jenkins会直接把它交给Groovy引擎执行。

自定义函数的执行机制 #

你定义的自定义函数并不是默认加载为Groovy类的run方法，而是作为Groovy脚本的顶层方法存在。当声明式Pipeline调用这些函数时，会临时切换到脚本式执行模式：

1. Jenkins先完成pipeline{}块的声明式结构解析和校验
2. 当执行到调用自定义函数的步骤时，会跳出声明式的约束，执行函数内的Groovy代码
3. 函数内的代码完全遵循Groovy语法，可以使用变量插值、循环、动态逻辑等所有Groovy特性

结合你的例子说明 #

报错场景：声明式内直接用变量作为stage名 #

stages {
    stage ("${any_stage_name}") { // 声明式不允许，解析阶段就会报错
        steps {
            // ...
        }
    }
}

声明式在解析时会检查stage名称是否为静态字符串，不支持变量插值，所以直接报错。

正常运行场景：自定义函数内使用变量stage名 #

def sampleFunc() {
    stage ("${any_stage_name}") { // Groovy处理变量插值，生成动态名称
        steps {
            // ...
        }
    }
}

pipeline {
    agent any
    stages {
        stage("Call Custom Func") {
            steps {
                script {
                    sampleFunc() // 切换到脚本式模式执行函数
                }
            }
        }
    }
}

调用sampleFunc()时，Jenkins进入脚本式执行模式，Groovy会处理${any_stage_name}的变量插值，动态生成stage名称，不会触发声明式的语法校验，所以能正常运行。

同理，for循环可以在自定义函数里使用，也是因为函数内是脚本式Groovy环境，不受声明式的结构限制。

补充：声明式内写灵活代码的另一种方式 #

如果不想把逻辑放到外部函数，也可以在声明式的steps里用script{}块包裹Groovy代码，效果和自定义函数一致：

pipeline {
    agent any
    stages {
        stage("Dynamic Stages") {
            steps {
                script {
                    for (int i = 1; i <= 3; i++) {
                        stage("Stage ${i}") {
                            echo "Running stage ${i}"
                        }
                    }
                }
            }
        }
    }
}

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