如何解决Jenkins共享库报错‘需包含src或vars目录至少其一’

一、报错原因及修复 #

你遇到的“Library expected to contain at least one of src or vars directories”错误，核心原因是全局共享库的SourcePath配置不符合Jenkins的路径解析规则*：

• 你的仓库结构是仓库根目录/Jenkins/Library/vars/common_code.groovy，在Jenkins「Global Pipeline Libraries」配置时，SourcePath需填写仓库内的相对路径Jenkins/Library（不要加开头的斜杠/）。如果填了/Jenkins/Library/，Jenkins会将其识别为服务器本地的绝对路径，而非仓库内的子目录路径，导致拉取的目录下找不到vars文件夹，触发报错。
• 额外验证点：确认vars目录和common_code.groovy已正常提交并推送到仓库，没有被.gitignore规则排除。

二、替代方案推荐 #

如果只是单纯共享Groovy工具代码，除了Shared Libraries，还有两种更轻量的选择：

• 使用load方法直接加载脚本：无需配置全局共享库，借助Jenkins原生的load步骤直接读取仓库内的Groovy文件。示例：

  def commonCode = load "${env.WORKSPACE}/Jenkins/Library/vars/common_code.groovy"
  commonCode.yourMethod() // 调用脚本内的自定义方法
  

  优势是无需全局配置，适合小型复用场景；缺点是每个Jenkinsfile都要手动写加载路径，且缺少共享库的语法补全支持。
• 封装为Groovy类（适合复杂逻辑）：如果你的代码更适合面向对象结构，可以在Jenkins/Library下新增src目录，将代码封装为Groovy类（比如src/com/yourteam/CommonCode.groovy），然后在Jenkinsfile中导入使用：

  @Library('your-lib-name') _
  import com.yourteam.CommonCode
  def common = new CommonCode()
  common.yourMethod()
  

  这种方式结构更清晰，适合复杂逻辑的复用，但需要额外创建src目录。

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