常规（非多分支）Jenkins流水线作业如何在脚本中检出对应分支？

我完全懂你的痛点——用env.JOB_BASE_NAME绑定分支名确实太死板，分支改名就得同步改作业名，不仅麻烦还容易漏改，而多分支流水线对你的场景来说又过于冗余。下面给你几个实用的方案，帮你把分支名的配置集中到一处，彻底告别重复修改：

方法1：参数化构建，把分支名做成可配置参数 #

这是最直观也最常用的方式，只需要两步：

1. 打开你的常规流水线作业配置，找到「参数化构建过程」，添加一个字符串参数，比如命名为TARGET_BRANCH，默认值设为你当前要关联的分支（比如main或者feature/user-auth）。
2. 在Jenkinsfile里直接引用这个参数来检出代码：

checkout(scm: [$class: 'GitSCM', 
              branches: [[name: params.TARGET_BRANCH]], 
              userRemoteConfigs: [[url: '你的Git仓库地址']]
             ])

之后要切换分支的话，只需要修改作业配置里的TARGET_BRANCH默认值，或者在手动构建时临时指定分支名，完全不用改作业名或者Jenkinsfile，从根源上避免了重复修改的错误。

方法2：给作业注入专属环境变量存储分支名 #

如果不想用参数化，也可以把分支名存在作业的环境变量里：

1. 在作业配置的「构建环境」部分，勾选「注入环境变量」，然后在「Properties Content」里填写类似BRANCH_NAME=feature/payment-optimize的内容。
2. 在Jenkinsfile里直接读取这个环境变量：

checkout(scm: [$class: 'GitSCM', 
              branches: [[name: env.BRANCH_NAME]], 
              userRemoteConfigs: [[url: '你的Git仓库地址']]
             ])

这种方式把分支名的配置集中在作业的环境变量里，作业名可以随便取，和分支名彻底解耦，修改分支只需要改这一处配置。

方法3：用作业描述字段存储分支名（灵活但需权限） #

如果你想更灵活，甚至可以把分支名写在作业的描述里，然后通过Jenkins脚本读取：

1. 在作业配置的「描述」框里填写你要关联的分支名。
2. 在Jenkinsfile里添加脚本获取描述内容：

// 获取当前作业对象
def currentJob = Jenkins.instance.getItem(env.JOB_NAME)
// 从描述中取出分支名
def targetBranch = currentJob.description

checkout(scm: [$class: 'GitSCM', 
              branches: [[name: targetBranch]], 
              userRemoteConfigs: [[url: '你的Git仓库地址']]
             ])

⚠️ 注意：这种方式需要给流水线脚本授予读取作业配置的权限，你需要在Jenkins的「全局安全配置」里，要么调整脚本安全策略，要么通过「脚本批准」功能允许相关API调用。

总结 #

不管用哪种方法，核心思路都是把分支名的配置从「作业名+Jenkinsfile」两处，集中到单一配置点，这样既不用绑定作业名和分支名，也不用引入复杂的多分支流水线，完美适配你的场景。

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