如何从Jenkins共享库中导入Groovy类至流水线

咱们一步步拆解你遇到的问题，先理清之前踩的两个坑，再给出标准的实现步骤：

先分析你之前的错误原因 #

1. 第一个错误（无法解析ClassTest）：
   你一开始把类放在src根目录且未添加包声明，虽然Groovy允许无包类，但Jenkins共享库的类加载机制更贴合Java的包结构规范，无包类在流水线沙箱中容易出现加载异常，同时这种方式也不利于代码的模块化组织，并不推荐。

2. 第二个错误（unexpected token: package）：
   问题出在流水线的语法格式上——你把@Library注解和import语句写在了同一行！Jenkins的Groovy解析器不支持这种写法，必须将@Library单独占一行，并且后面要加上下划线_（用来表示加载共享库但不自动执行全局变量脚本）。

正确的实现步骤 #

第一步：规范共享库的类文件结构 #

1. 按照Java/Groovy的包结构规则，将类文件放在src/com/company/ClassTest.groovy（包路径可根据你的实际需求调整）
2. 在类文件顶部正确声明包，类代码需符合Groovy语法规范，示例如下：

package com.company

class ClassTest {
    // 你可以替换成自己的进程状态相关逻辑
    def getProcessStatus() {
        return "Running"
    }
}

第二步：流水线中正确导入并使用类 #

有两种推荐的写法：

写法一：使用@Library注解（更简洁，推荐）

// 加载指定分支的共享库，@main是分支名，默认分支可省略；_是必须的，避免自动执行全局变量
@Library('testlibrary@main') _
// 导入包路径下的目标类
import com.company.ClassTest

// 实例化类并调用方法
def testObj = new ClassTest()
println "Process status: ${testObj.getProcessStatus()}"

写法二：使用library()方法动态加载

如果需要更灵活的加载逻辑（比如根据条件加载不同分支），可以采用这种方式：

// 加载指定分支的共享库
library('testlibrary@main')
// 导入目标类
import com.company.ClassTest

// 实例化类并执行业务逻辑
def testObj = new ClassTest()
testObj.getProcessStatus()

额外注意事项 #

• 确保你的共享库已经在Jenkins全局配置中正确注册，名称与你使用的testlibrary一致
• 如果你的类在共享库的默认分支（比如main），可以省略分支标识，写成@Library('testlibrary') _
• 类中的方法和属性要符合Groovy语法，若需在Jenkins沙箱中运行，要避免使用被禁止的危险方法

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