如何配置Jenkins使其每次触发时构建最新GitHub Tag？

我之前也遇到过一模一样的情况——单任务拉取所有Tag后，每次触发都要遍历一遍旧Tag，还总是跑旧版本的构建，折腾了一阵终于找到靠谱的方案，给你整理一下：

为什么会遍历所有旧Tag？ #

你当前的+refs/tags/*:refs/remotes/origin/tags/*这个refspec确实会拉取仓库所有Tag，而Jenkins默认会把每个Tag都当作一个可构建的候选版本，触发任务时就会逐个扫描，自然会出现构建旧Tag的情况。要解决这个问题，核心是主动控制只获取并构建最新的Tag，而不是让Jenkins自动扫描所有Tag。

具体配置步骤 #

1. 保留现有Refspec（或按需优化）

你的refspec设置没问题，它能确保Jenkins拉取所有Tag的元信息，我们后续要做的是在Pipeline脚本里筛选出最新的那个即可。

2. 修改Pipeline脚本，动态获取并检出最新Tag

把原来的默认checkout逻辑替换成主动获取最新Tag的脚本，这样每次任务运行时都会自动定位到仓库里按提交时间排序的最新Tag：

pipeline {
    agent any
    stages {
        stage('定位最新Tag') {
            steps {
                script {
                    // 通过Git命令获取按提交时间排序的第一个Tag（最新的）
                    def latestTag = sh(
                        script: 'git ls-remote --tags --sort=-committerdate origin | head -n 1 | awk \'{print $2}\' | sed \'s/refs\\/tags\\///\'',
                        returnStdout: true
                    ).trim()
                    echo "本次将构建最新Tag: ${latestTag}"
                    
                    // 检出这个最新Tag
                    checkout([
                        $class: 'GitSCM',
                        branches: [[name: latestTag]],
                        userRemoteConfigs: [[
                            url: '你的GitHub仓库地址',
                            refspec: '+refs/tags/*:refs/remotes/origin/tags/*'
                        ]]
                    ])
                }
            }
        }
        stage('执行构建') {
            steps {
                echo "开始构建Tag: ${latestTag}"
                // 这里替换成你的实际构建命令，比如 mvn clean package、npm run build 等
            }
        }
    }
}

3. 配置GitHub触发，确保推送新Tag时自动运行

在Jenkins任务的「构建触发器」里勾选「GitHub hook trigger for GITScm polling」，这样每次你往GitHub推送新Tag时，都会自动触发这个Pipeline任务，而任务会直接拉取最新的Tag构建，不会再遍历旧Tag。

额外说明 #

如果你的需求是只构建刚推送的那个Tag（而不是仓库里所有Tag中最新的），可以结合GitHub Webhook的payload信息来获取推送的Tag名称，不过这种方式需要处理payload解析，步骤稍复杂。如果只是要每次触发都构建当前最新的Tag，上面的方案就足够简单可靠了。

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