Groovy脚本全局方法定义方法（Jenkins流水线场景）

我来给你梳理下在Jenkins流水线里实现全局可调用方法的几种实用方式，刚好对应你提到的需求：

1. 单流水线内的全局方法 #

如果只是在当前流水线的各个stage里复用方法，直接在所有stage代码的外面用def定义方法就行，这个方法在整个流水线上下文里都是全局可访问的。

举个Declarative Pipeline的例子：

// 全局方法定义，放在pipeline块的外面
def printBuildInfo(String stageName) {
    echo "===== 当前Stage: ${stageName} ====="
    echo "构建编号: ${BUILD_NUMBER}"
}

pipeline {
    agent any
    stages {
        stage('代码拉取') {
            steps {
                script {
                    // 在stage里调用全局方法，Declarative里要包在script块里
                    printBuildInfo('代码拉取')
                }
                git url: 'https://your-repo-url.git'
            }
        }
        stage('构建打包') {
            steps {
                script {
                    printBuildInfo('构建打包')
                }
                sh 'mvn clean package -DskipTests'
            }
        }
    }
}

这里要注意，在Declarative Pipeline的steps中调用自定义Groovy方法时，必须把调用逻辑放在script块里——这是Declarative的语法规范。如果是Scripted Pipeline，就不用这么麻烦，直接在stage里调用方法就行。

2. 多流水线复用的全局方法 #

要是你想让这个方法能在多个不同的Jenkins流水线里复用，那用Jenkins共享库是最佳方案：

1. 先在Jenkins后台（Manage Jenkins → Configure System → Global Pipeline Libraries）配置一个共享库，关联你的代码仓库。
2. 在共享库的vars目录下创建一个Groovy文件（比如buildUtils.groovy），在里面定义方法：

// vars/buildUtils.groovy
def call(String stageName) {
    echo "===== 当前Stage: ${stageName} ====="
    echo "构建编号: ${BUILD_NUMBER}"
}

3. 在你的流水线里引用共享库后，就能直接调用方法了：

@Library('your-shared-library-name') _

pipeline {
    agent any
    stages {
        stage('代码拉取') {
            steps {
                // 直接调用共享库的全局方法，不用包script块
                buildUtils('代码拉取')
                git url: 'https://your-repo-url.git'
            }
        }
    }
}

另外补充下你提到的点：Groovy里方法确实必须用def（或者指定返回类型）来定义，不管是全局还是局部，这和变量不用def就变成全局的规则不一样。但在Jenkins流水线的顶层定义的def方法，本身就属于全局上下文，各个stage都能访问到。

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