如何在 Groovy 中动态引用变量名(如通过字符串拼接访问变量)

groovy 不支持直接通过字符串名称访问局部变量,但可通过 this."variablename" 动态读取类/脚本级属性;局部变量需改用 map 或绑定方式管理。

在 Groovy(尤其 Jenkins Pipeline 脚本或 Groovy 脚本中),常遇到需要根据运行时字符串动态引用变量的场景,例如你希望根据 CODEBASE 值(如 "dcihub")自动获取对应变量 dcihub_sonar_binaries 的值。但直接写 "${CODEBASE}_sonar_binaries" 只会得到字面字符串,而非该变量的实际内容——这是因为 Groovy 无法在运行时解析局部变量名

✅ 正确做法:使用 this."propertyName"(适用于脚本级/类成员变量)

Groovy 脚本默认编译为 Script 子类实例,所有顶层定义的变量(

非 def 局部声明)会被提升为脚本对象的属性(property)。因此,若将变量声明为脚本级属性(即不加 def),即可通过 this."name" 动态访问:

// ✅ 正确:声明为脚本属性(无 def)
dcihub_sonar_binaries = '$WORKSPACE/tenants/dcihub/ui.apps/target/,$WORKSPACE/tenants/dcihub/ui.config/target/,$WORKSPACE/tenants/dcihub/ui.content/target/'

def CODEBASE = "dcihub"
def SonarValues = [:]

if (CODEBASE == "platform") {
    SonarValues["platform"] = [platform_sonar_exclusion, platform_sonar_binaries]
} else {
    // ✅ 动态读取属性:this."dcihub_sonar_binaries"
    SonarValues[CODEBASE] = this."${CODEBASE}_sonar_binaries"
}

return SonarValues
⚠️ 注意:platform_sonar_exclusion 和 platform_sonar_binaries 同样需为脚本级属性(非 def 局部变量),否则会抛出 MissingPropertyException。

❌ 错误示例:def 声明的局部变量不可反射访问

def dcihub_sonar_binaries = '...'  // ← 局部变量,作用域仅限当前 block
println this."dcihub_sonar_binaries" // ❌ MissingPropertyException

def 创建的是局部变量(local variable),不属于对象属性,无法通过 this. 或反射访问。

✅ 更健壮的替代方案:统一使用 Map 管理配置

为避免属性可见性问题,推荐将所有配置变量存入一个中心化 Map,既清晰又安全:

def configs = [
    dcihub_sonar_binaries: '$WORKSPACE/tenants/dcihub/ui.apps/target/,...',
    platform_sonar_binaries: '$WORKSPACE/platform/...'
]

def CODEBASE = "dcihub"
def SonarValues = [:]

if (CODEBASE == "platform") {
    SonarValues["platform"] = [
        configs.platform_sonar_exclusion,
        configs.platform_sonar_binaries
    ]
} else {
    SonarValues[CODEBASE] = configs["${CODEBASE}_sonar_binaries"]
}

return SonarValues

? 补充说明:binding 也可用于 Jenkins Pipeline

在 Jenkins Pipeline(Jenkinsfile)中,还可利用 binding.variables(需 @Field 或显式注入),但更推荐上述 Map 方式,因其可读性强、无隐式依赖、易于单元测试。

✅ 总结

场景 是否可行 推荐方式
脚本顶层变量(无 def) ✅ 可用 this."name" 简单脚本适用
def 局部变量 ❌ 不可反射访问 改用 Map 或闭包参数传递
多环境配置 ✅✅ 强烈推荐 Map 结构 易维护、类型安全、无作用域陷阱

动态变量引用不是 Groovy 的设计重点,显式优于隐式。优先选择 Map、配置类或参数化方法,让逻辑更可靠、更易调试。