如何参数化Jenkinsfile任务？实现多Pipeline任务复用同一Jenkinsfile

我之前处理过几乎一模一样的场景，复用Jenkinsfile确实能大幅减少重复维护的工作量，给你几个亲测好用的方案：

方案1：给每个任务配置专属环境变量 #

这是最直接的方式，不用修改Jenkinsfile的核心逻辑，只需要在任务层面配置变量：

• 打开你的Pipeline任务配置页面，找到**「构建环境」**板块（部分Jenkins版本在「高级」选项里）
• 勾选「注入环境变量」，添加一个自定义变量（比如TARGET_NAME），值填当前任务对应的name参数
• 在Jenkinsfile里直接通过env.TARGET_NAME调用这个变量，示例代码：

pipeline {
    agent any
    stages {
        stage('Build') {
            steps {
                echo "开始构建项目：${env.TARGET_NAME}"
                // 替换成你的实际构建逻辑，所有需要用到name的地方都用env.TARGET_NAME
                sh "./build.sh --project ${env.TARGET_NAME}"
            }
        }
    }
}

方案2：多分支Pipeline解析JOB_NAME #

如果用的是多分支Pipeline，虽然默认的JOB_NAME是分支名，但可以通过字符串解析提取出你需要的name：
比如你的分支命名规则是service-${name}或者${name}-dev，可以在Jenkinsfile里做简单的字符串处理：

// 假设JOB_NAME格式是「项目名/分支名」，分支名就是我们需要的name
def targetName = env.JOB_NAME.split('/').last()

// 如果分支名有前缀/后缀，比如「my-service-api-dev」，可以进一步处理
// def targetName = env.JOB_NAME.split('/').last().replace('-dev', '')

pipeline {
    agent any
    stages {
        stage('Deploy') {
            steps {
                echo "部署服务：${targetName}"
                sh "./deploy.sh --name ${targetName}"
            }
        }
    }
}

这种方式不需要额外配置任务，完全靠命名规则和代码解析实现复用。

方案3：参数化构建设置默认值 #

如果希望保留手动传参的灵活性，同时默认复用任务专属的name，可以用参数化构建：

• 在任务配置里添加**「字符串参数」**，名称设为PROJECT_NAME，默认值填当前任务对应的name
• Jenkinsfile里通过params.PROJECT_NAME调用，示例：

pipeline {
    agent any
    parameters {
        string(name: 'PROJECT_NAME', description: '项目名称')
    }
    stages {
        stage('Test') {
            steps {
                echo "测试项目：${params.PROJECT_NAME}"
                sh "./test.sh --target ${params.PROJECT_NAME}"
            }
        }
    }
}

触发构建时如果不手动修改参数，就会自动使用任务配置里的默认值，完美兼顾复用性和灵活性。

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