如何在Jenkins中测试自定义分支的Jenkins共享库？

方法1：动态加载指定分支的共享库 #

@Library注解确实不支持变量插值，改用library函数动态加载是可行方案，但要注意禁用自动加载的默认共享库，避免冲突报错。

示例流水线代码：

pipeline {
    agent any
    stages {
        stage('Test Shared Library') {
            steps {
                script {
                    // 禁用自动加载的共享库，避免和动态加载版本冲突
                    @Library('') _
                    // 动态加载当前分支的共享库，替换为你的库名
                    def myLib = library("myrepo@${env.BRANCH_NAME}")
                    // 通过库实例调用目标方法
                    myLib.basicPipeline(nodeLabel: 'node') {
                        echo 'Hello, World!'
                    }
                }
            }
        }
    }
}

如果Jenkins全局配置里设置了该共享库的自动加载，必须加上@Library('') _来覆盖自动加载规则，否则会出现Only using first definition of library的提示，依旧走默认分支。

方法2：直接加载本地共享库文件（同仓库场景） #

如果测试流水线和共享库代码在同一个Git仓库，完全可以绕过Jenkins共享库机制，直接加载本地文件：

示例流水线代码：

pipeline {
    agent any
    stages {
        stage('Test Local Shared Lib') {
            steps {
                script {
                    // 加载当前分支下的本地groovy文件
                    load 'vars/basicPipeline.groovy'
                    // 直接调用函数
                    basicPipeline(nodeLabel: 'node') {
                        echo 'Hello, World!'
                    }
                }
            }
        }
    }
}

这种方式直接使用当前分支的本地代码，完全不受Jenkins共享库缓存影响，适合在同一个仓库内快速验证修改。

方法3：临时修改Jenkins全局配置（快速测试） #

如果只是临时验证某个分支，不想修改流水线代码，可以：

• 进入Jenkins全局配置（Manage Jenkins → Configure System）
• 找到目标共享库的配置项，把默认分支从master改成你要测试的分支
• 测试完成后改回原分支

该方法适合单人快速测试，但不适合多人协作场景，避免影响其他流水线的正常运行。

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