Jenkins Pipeline中如何在git分支配置中动态使用当前构建分支名称？

我太懂你这个困扰了——想让Jenkins自动跟着当前触发构建的分支走，不用每次合并分支后还要手动改流水线里硬编码的分支名，试了一堆变量结果全报找不到修订版本，硬编码虽然能跑但完全不灵活，确实闹心😅

先帮你揪出之前踩的坑：你之前写的git branch: '${env.BRANCH_NAME}'用了单引号，在Groovy语法里，单引号包裹的字符串是字面量，Jenkins不会解析里面的${}变量，它真的会去远程仓库找一个叫${env.BRANCH_NAME}的分支，那肯定找不到啊！这是最核心的问题。

下面分两种流水线场景给你对应的解决办法，都是亲测能用的：

一、如果你用的是多分支流水线（Multibranch Pipeline） #

多分支流水线本身就是为多分支场景设计的，默认就会自动关联触发构建的分支，其实你甚至可以不用手动指定branch参数，直接用checkout scm就能自动拉取当前分支：

steps {
    checkout scm
}

如果一定要显式指定分支（比如自定义了SCM配置），那记得用双引号包裹变量，让Groovy解析出真实的分支名：

steps {
    git branch: "${env.BRANCH_NAME}", credentialsId: 'jenkins', url: 'redacted'
}

这里的env.BRANCH_NAME是多分支流水线里最可靠的变量，会准确返回当前触发构建的分支名（比如master、test），合并分支后也会自动切换到目标分支，完全不用改配置。

二、如果你用的是单分支流水线（Single Branch Pipeline） #

单分支流水线里env.BRANCH_NAME可能不会默认赋值，这时候可以用下面两种方式：

1. 用checkout步骤配合完整的SCM配置，注意分支名前加*/匹配远程分支：

steps {
    checkout scm: [
        $class: 'GitSCM',
        userRemoteConfigs: [[url: 'redacted', credentialsId: 'jenkins']],
        branches: [[name: "*/${env.BRANCH_NAME}"]]
    ]
}

2. 先打印变量确认值，再用git命令直接拉取：

steps {
    // 先确认变量是否正确，方便排查问题
    echo "当前要构建的分支是: ${env.BRANCH_NAME}"
    sh "git clone -b ${env.BRANCH_NAME} https://your-repo-url.git ."
}

如果是PR触发的构建，还可以用env.CHANGE_TARGET变量获取目标分支名。

额外的排查小技巧 #

如果还是不确定变量是否正确，可以在流水线里先打印所有环境变量，看看哪个是你需要的：

steps {
    sh 'printenv'
}

这样就能清楚看到当前Jenkins环境里所有可用的变量，找到对应分支的那个再用就行。

之前你试的GIT_BRANCH、GIT_LOCAL_BRANCH这些变量，很多是在checkout完成后才会被Jenkins设置的，在checkout步骤之前调用的话，变量是空的，自然也会报错找不到分支。

这样配置后，不管你是合并test到master，还是从其他分支触发构建，流水线都会自动拉取对应的分支，完全不用手动改硬编码的分支名啦！

备注：内容来源于stack exchange，提问作者majorgear