如何在Jenkins SCM构建流水线中动态设置分支名称？

核心问题分析 #

Pipeline script from SCM模式下，Jenkins会先拉取GUI配置中「Branch Specifier」指定分支的Jenkinsfile，再执行脚本内的checkout逻辑。留空该字段时，Jenkins默认拉取仓库默认分支（如main）的Jenkinsfile，导致后续checkout可能与触发分支不匹配。

具体解决方案 #

1. GUI配置调整 #

• Branch Specifier设置：不要留空，填入**（匹配所有分支）。如果你的Jenkinsfile仅存于默认分支（如main），且希望所有分支都用该分支的Jenkinsfile执行，可直接填main。
• 触发器配置：勾选对应SCM的触发器（如「GitHub hook trigger for GITScm polling」），确保分支推送事件能触发构建。

2. Jenkinsfile修改 #

利用Jenkins触发构建时自动注入的BRANCH_NAME环境变量（值为当前触发的分支名），替换原脚本中固定的分支引用：

pipeline {
    agent any

    stages {
        stage('拉取代码') {
            steps {
                checkout poll: false, scm: scmGit(
                    branches: [[name: "${BRANCH_NAME}"]],
                    extensions: [submodule(parentCredentials: true, recursiveSubmodules: true, reference: '')],
                    userRemoteConfigs: [[
                        credentialsId: 'xxxxx',
                        url: 'https://github.com/xxx/xxx.git'
                    ]]
                )
            }
        }
        // 后续阶段...
    }
}

3. 两种场景适配 #

场景A：Jenkinsfile仅存于默认分支

• GUI的Branch Specifier填main，确保始终拉取默认分支的Jenkinsfile
• Jenkinsfile中用BRANCH_NAME拉取触发分支的代码，实现分支逻辑统一管控

场景B：Jenkinsfile随分支同步更新

• GUI的Branch Specifier填**，Jenkins会拉取触发分支的Jenkinsfile执行
• 脚本内的checkout仍用BRANCH_NAME，保证拉取当前触发分支的代码（若无需自定义子模块等配置，也可直接用checkout scm简化代码）

验证方法 #

手动触发构建时，选择任意分支测试，查看控制台输出确认拉取的分支是否与选择的一致；再推送代码到某分支，检查是否自动触发构建并拉取正确分支。

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