如何在Jenkins Pipeline的withGroovy步骤中定义变量？

问题根源 #

Jenkins Pipeline的Workflow脚本虽基于Groovy，但执行逻辑有特殊规则：顶层代码默认会被当成DSL步骤解析。你直接写def content = "Hello World"这类标准Groovy变量定义时，引擎会误判这是一个不存在的DSL步骤，因此抛出Expected a step错误——这和插件配置无关，属于语法规则问题。

解决方法 #

要在Pipeline中编写标准Groovy代码（包括变量定义、条件判断、循环等），必须把代码用script块包裹起来，不管是在withGroovy还是其他步骤上下文里都适用。

示例代码：

pipeline {
    agent any
    stages {
        stage('执行System Groovy脚本') {
            steps {
                script {
                    // 这里可正常编写标准Groovy代码
                    def content = "Hello World"
                    println(content)
                    
                    // 其他Groovy逻辑也能正常运行
                    def count = 15
                    if (count > 10) {
                        println("数值大于10")
                    }
                }
            }
        }
    }
}

关于withGroovy的说明 #

如果你的withGroovy是自定义步骤或插件提供的执行上下文，只要在其中嵌入script块，就能正常使用标准Groovy语法。核心就是用script块明确告知Pipeline引擎：这段是标准Groovy代码，而非DSL步骤。

额外提醒 #

• 若使用systemGroovyScript步骤执行系统级脚本（比如操作Jenkins内部API），脚本本身可直接用标准Groovy，但如果是在Pipeline的Workflow流程里调用，仍需遵守上述规则。
• 你已安装的Pipeline: Groovy插件完全满足需求，无需额外配置其他插件。

内容的提问来源于stack exchange，提问作者Edward Partlow Jr